🛒 Simulating Supermarket Voucher Purchase with Dummy Product (ID: 9993)

This guide explains how to simulate the purchase of supermarket vouchers using the dummy product 9993 in the CSQ API. It is designed for developers testing voucher flows in the Supermarket Vouchers category, using real API methods without triggering actual transactions or contacting external suppliers.

📦 Dummy Product Overview

Product ID	Product Name	Behavior Summary
`9993`	DummySuperMarket	Simulates supermarket voucher purchase in one step

✅ This dummy product does not require token retrieval or additional queries. It is ideal for testing simple voucher purchase flows.

🛒 Dummy Flow for Supermarket Vouchers

The dummy supermarket voucher flow has been deliberately designed for simplicity: it requires just one direct call to the purchase method to simulate a complete transaction. There are no preliminary steps like parameter discovery or dynamic product selection. This streamlined design makes the flow ideal for quick integration testing, allowing developers to validate response handling and success/error scenarios without navigating through multi-step logic.

Simulate Voucher Purchase

Method
POST /supermarket-vouchers/purchase/{terminalId}/{operatorId}/{localReference}

Required Payload Fields

{
  "amountToSendX100": 5000,
  "localDateTime": "2025-07-08T10:00:00Z",
  "documentNumber": "AB00000000"
}

🔍 Field Descriptions

Field	Type	Description
`amountToSendX100`	integer	Amount in cents (e.g. 500 = 5.00)
`localDateTime`	string	ISO 8601 timestamp of the simulated purchase
`documentNumber`	string	Simulated ID or passport number.

🧪 Behavior Based on `documentNumber` Suffix

Ends With	Simulated Result
`000`	✅ Success and returns `suppliertoken: FDSAGHJKLREWQTYUIO`
`001`	✅ Success and returns `suppliertoken: POIUYTREWQJHGFDSA`
other	❌ Error 931 - invalid account

Use this logic to test different outcomes by modifying the last digits of the documentNumber field.

📤 Response Example

{
  "rc": 0,
  "items": [
    {
      "finalstatus": 0,
      "resultcode": "10",
      "resultmessage": "Voucher purchase successful",
      "supplierreference": "SUP-REF-78910",
      "suppliertoken": "FDSAGHJKLREWQTYUIO",
      "destinationcurrency": "EUR",
      "destinationamount": 500
    }
  ]
}

🧠 Developer Notes

This dummy product simulates a single-step purchase — no token or query required.

Use amountToSendX100 to test different denominations.

The documentNumber field acts as a trigger for specific test results.

Always log and handle resultcode and resultmessage in the response.

Supermarket Vouchers Purchase Simulation

🛒 Simulating Supermarket Voucher Purchase with Dummy Product (ID: 9993)#

📦 Dummy Product Overview#

🛒 Dummy Flow for Supermarket Vouchers#

Simulate Voucher Purchase#

🔍 Field Descriptions#

🧪 Behavior Based on documentNumber Suffix#

📤 Response Example#

🧠 Developer Notes#