Voucher Pay
Hosted payments in EUR and USD with fixed denominations
Before you start
Authorization
How to sign your requests with the API token.
Create payment
The base order request that this page extends.
This payment method is not enabled for all merchants. Check availability with your manager.
Overview
Voucher Pay uses the standard create payment endpoint. Redirect the payer to the returned paymentLink to complete the payment on the hosted page.
| Parameter | Supported values |
|---|---|
| Currency | EUR, USD |
| Amount | 5, 10, 15, 25, 30, 50, 100 |
| Payer details | No method-specific customer fields required |
| Payment flow | Hosted page; H2H card submission is not supported |
Ask your manager to enable Voucher Pay and provide the corresponding serviceId. You do not need extraParams, card details or a separate provider API key.
Amount restrictions
The amount sent for collection must match one of the supported denominations exactly. For example, 10.00 is supported; 11.00 and 10.50 are not. The same denominations apply to both currencies.
Passing fees to the payer can change the collection amount and make it unsupported. Ask your manager to configure fees so the final collection amount remains a supported denomination.
Request example
Use the serviceId provided for this method instead of the example value 3.
curl -X POST "https://api.panel.valutix.kz/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": "10.00",
"currency": "EUR",
"serviceId": 3,
"externalId": "order_12345",
"isFeeOnUser": false,
"successUrl": "https://example.com/success",
"callbackUrl": "https://example.com/webhooks/payments"
}'Response and payment result
The response is the standard order object. Redirect the payer to its paymentLink.
The response is a standard order object. The order is created with the CREATED status; redirect the payer to paymentLink to complete the payment.
Order object fields
Only the order status COMPLETED confirms payment. Receive the result through the standard order webhook or status endpoint. Webhook signing and the order status format are unchanged for this method.
Return from the payment page
The return URL is configured when the method is connected and must use an HTTPS domain agreed with the provider. Ask your manager to configure it; the hosted page uses this configured address rather than the order's successUrl or failUrl.
successUrl is still required in the request or merchant settings by the standard order creation contract, although it is not forwarded to this hosted page.
Returning to your site does not confirm payment. Check the order status before fulfilling the order.