Skip to main content

​
Request IDs

Every request must have a unique identifier.
  • Format: Alphanumeric with hyphens (e.g., refuel-12345).
  • Context: Include business logic in the ID to make logs easier to read.

​
Amount handling

VPOS uses minor units to avoid floating-point errors.
  • If decimalPlace is 2, $1.00 is sent as 100.
  • If decimalPlace is 3, $1.00 is sent as 1000.

​
Conventional timeouts

The client system should manage timeouts to ensure the terminal doesn’t hang indefinitely:

​
Error handling

  • Logging: Always store the errorCode and errorMessage.
  • Retries: Do not retry DECLINED transactions. A decline is a final response from the bank; the user must provide a different payment method.