CSQ Docs
    CSQ Docs
    CSQ API Doc
    • CSQ API Doc
    • Dummy Product Usage Guide
    • Prepaid
    • Vouchers
    • Get Dynamic Vouchers
      GET
    • Vouchers Purchase
      POST
    • Voucher Additional Data
      GET
    • Get Resolved Vouchers
      GET

      Get Resolved Vouchers

      GET
      /pre-paid/vouchers/finished-products/{terminalId}/{operatorId}

      🎯 Get Finished Voucher List#

      Retrieves the list of finished or resolved voucher products for a given terminal and operator. This endpoint is only used to collect results for vouchers that require a planned outcome of delayed processes, such as raffles or prize draws.

      🔍 Description#

      Some voucher products (e.g., raffles or dynamic incentive flows) do not yield an immediate result at the time of purchase. This endpoint allows clients to retrieve a list of finalized voucher outcomes that have been awarded or resolved for a specific terminal and operator.

      📥 Path Parameters#

      ParameterTypeRequiredDescription
      terminalIdinteger✅ YesID of the terminal to filter retrieved results
      operatorIdinteger✅ YesID of the product

      📤 Response#

      Returns an array of finished product objects, each including:
      id: Internal product identifier
      description: Human-readable description of the prize or voucher
      amountToSendX100, destinationAmountX100: Value of the voucher (in cents)
      destinationCurrency: Currency of the voucher
      serviceFeeX100, totalAmountX100: Fee structure breakdown (optional)
      additionalData: Key-value pairs for extra data (e.g., prize tier, barcode, messages)

      🧠 Usage Notes#

      This endpoint is typically used after a raffle-based or deferred voucher flow, when the outcome is not available immediately in the purchase response.

      Request

      Path Params

      Header Params

      Request Code Samples

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location --request GET 'https://evsb.csqworld.com/pre-paid/vouchers/finished-products//' \
      --header 'U;' \
      --header 'SH;' \
      --header 'ST;'

      Responses

      🟢200OK
      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"
              }
          ]
      }
      Modified at 2025-07-11 10:38:17
      Previous
      Voucher Additional Data
      Built with