Skip to main content

Testing

Sandbox Environment​

Base URLhttps://api.dev.votesess.com
Test Apphttps://dev.app.uniqpon.com

Setup​

  1. Obtain your sandbox API key(s) -- one per terminal. Contact the Cheers team for provisioning.
  2. Configure your POS terminals with the respective X-API-Key values.

A single terminal is sufficient for testing.

Buying Test Credits​

  1. Go to the test credit purchase page
  2. Register with an email address (registration = login on the test platform)
  3. Purchase credits using the Barion test card: 4444 8888 8888 5559
  4. Verify credits at Profile > Credits

Generating a Transaction Key​

  1. Log in to the test app
  2. Go to Profile > QR Code
  3. Click the QR code button to generate a dynamic QR code
  4. Scan this QR code to extract the X-Transaction-Key

If you scan an NFC card instead, left-pad the value to 32 characters with padStart(32, "0") first — see Authentication.

Test Flow​

1. Preview​

Call the preview endpoint with test items:

curl -X POST https://api.dev.votesess.com/v3/integrations/credit-transactions/preview \
  -H "X-API-Key: YOUR_SANDBOX_API_KEY" \
  -H "X-Transaction-Key: SCANNED_QR_VALUE" \
  -H "X-Idempotency-Key: UNIQUE_KEY_PER_REQUEST" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentType": "SPLIT_PAYMENT",
    "currencyCode": "HUF",
    "items": [
      {
        "productId": "test-product-001",
        "quantity": 2,
        "unitPrice": 500,
        "name": "Test Product",
        "vat": 27
      }
    ]
  }'

2. Finalize​

Call the finalize endpoint with the transactionId from the preview response.

3. Verify​

Check the user's credit balance in the test app to confirm credits were deducted.

4. Refund​

Call the refund endpoint and verify credits are restored.

Production Testing​

Once sandbox testing is complete, repeat the flow against the production environment:

Base URLhttps://api.uniqpon.com
Apphttps://cheersapp.io

Use production API keys and real user accounts for final validation.