Skip to main content
This endpoint requires HMAC-SHA256 authentication. See Authentication for signature computation details.

​
Long-Polling Behavior

This endpoint uses long-polling and waits up to 90 seconds for the terminal to respond. Plan for this timeout in your HTTP client configuration.

​
Terminal ID Resolution

The terminalId parameter is resolved in the following order:
  1. Device ID (Recommended) - First checks if the ID matches a registered deviceId
  2. Connection ID (Fallback) - If no device ID match, treats it as a connectionId
Always use deviceId when available. It provides a stable reference that doesn’t change when terminals reconnect.

​
Handling Timeouts

If you receive a 504 Gateway Timeout response:
  1. Do not retry the payment immediately
  2. Use Get Transaction to check if the payment completed
  3. Only retry if the transaction status is FAILED or CANCELLED
The payment may have completed on the terminal after the HTTP timeout. Always verify transaction status before retrying to avoid duplicate charges.