Create Voucher Payment

POST

/api/v1/voucher-payments

urchase vouchers from your wallet. One endpoint handles one-off sales and subscription
billing cycles — include subscription_access_code to bill a recurring subscription.

Important: Omit subscription_access_code for one-off sales. Include it — with exactly one voucher, quantity 1 — for subscription billing cycles.

One-off purchase

Sell vouchers directly to a customer. Debits your wallet by the total denomination value.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/voucher-payments' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "vouchers": [
        {
            "product_code": "CIAO-15",
            "quantity": 1
        }
    ],
    "customer_identifier": "1",
    "metadata": {
        "customer_id": 1,
        "order_id": 10
    }
}'

Response Example

{
    "status": true,
    "message": "Vouchers created successfully",
    "data": {
        "reference": "VOUCHER-01KY4WMBT2QPD0HE01RQC62D82",
        "vouchers": [
            {
                "code": "1234ABCDEG",
                "initial_balance": 2000,
                "initial_balance_display": "€20.00",
                "current_balance": 2000,
                "current_balance_display": "€20.00",
                "status": "active",
                "created_at": "2026-07-22T12:25:56.000000Z",
                "expires_at": "2027-07-22T12:25:56.000000Z",
                "blocked_at": null
            }
        ]
    }
}

Modified at 2026-07-22 12:31:30

Voucher Generation (Resellers)

Retrieve Voucher Payment

Create Voucher Payment

One-off purchase#

Request

Responses

One-off purchase