Get Dynamic Vouchers

📦 Get Dynamic Vouchers

Retrieves the list of available dynamic vouchers for a specific operatoId.

🔍 Description

This method is used when the operator provides dynamic vouchers, which are not predefined and must be queried in real time.

One common scenario for this method is checking available raffles or sweepstakes where tickets can still be purchased, thereby ensuring that only active products are offered for purchase.

Although this step can be skipped for most voucher types, our support team can help you identify which products require its use beforehand.

📥 Path Parameters

Parameter	Type	Description
`terminalId`	string	Identifier of the terminal making the request
`operatorId`	string	Identifier of the product

📤 Response

Returns a list of dynamic vouchers, each including the following fields:

id: Unique identifier of the dynamic voucher (used for purchasing)

description: Human-readable vouchers description

amountToSendX100, destinationAmountX100, serviceFeeX100, totalAmountX100: Amounts represented in hundredths of currency unit

destinationCurrency: Currency used by the operator (e.g., EUR, USD)

additionalData (optional, per product): A list of key-value pairs with informative data specific to the product.

In addition, the root object may also contain a general additionalData field with informative data that applies to the whole response, not to a specific product.

Both additionalData fields are optional and meant only for display; they are not required for placing a purchase.

🧠 Usage Notes

This endpoint should be called before placing a purchase order when dealing with specific operators that require dynamic product validation prior to purchase — such as raffles or sweepstakes.

If the response includes additionalData (at product or global level), you may display that information to the user, but it is not required during the purchase request.

application/json

Body

Example

{
    "rc": 0,
    "items": [
        {
            "amountToSendX100": 0,
            "destinationAmountX100": 0,
            "serviceFeeX100": 0,
            "totalAmountX100": 0,
            "destinationCurrency": "string",
            "id": "string",
            "description": "string",
            "additionalData": [
                {
                    "key": "string",
                    "value": "string"
                }
            ]
        }
    ],
    "additionalData": [
        {
            "key": "string",
            "value": "string"
        }
    ]
}

Get Dynamic Vouchers