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
      terminalId
      integer <int32>
      required
      operatorId
      integer <int32>
      required
      Header Params
      U
      string 
      required
      Default:
      {{U}}
      SH
      string 
      required
      Default:
      {{SH}}
      ST
      string 
      required
      Default:
      {{ST}}

      Request 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
      rc
      integer <int32>
      optional
      items
      array[object (DynamicProductDto) {8}] 
      optional
      amountToSendX100
      integer <int32>
      optional
      destinationAmountX100
      integer <int32>
      optional
      serviceFeeX100
      integer <int32>
      optional
      totalAmountX100
      integer <int32>
      optional
      destinationCurrency
      string 
      optional
      id
      string 
      optional
      description
      string 
      optional
      additionalData
      array[object (AdditionalDataDto) {2}] 
      optional
      additionalData
      array[object (AdditionalDataDto) {2}] 
      optional
      key
      string 
      optional
      value
      string 
      optional
      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