Financial operation request body
Used by: /sale, /preauth, /confirm, /cancel, /refund
Money format:
- All monetary fields are integers in minor units.
- Do not send decimal separators or floating-point values.
- Examples for a 2-decimal currency:
1.00 -> 100,125.50 -> 12550. - For zero-decimal currencies, the value matches the whole amount.
| Field | Type | Required | Description |
|---|---|---|---|
pay_id | string | Recommended | Integrator operation ID (idempotency key) |
terminal | long | No | Terminal numeric ID (see terminal/merchant resolution rules below) |
merchant | long | No | Merchant numeric ID (see terminal/merchant resolution rules below) |
amount | long | Yes | Transaction amount in minor units |
tips | long | No | Tip amount in minor units |
cashback | long | No | Cashback amount in minor units |
rrn | string | Operation-dependent | Reference number for linked operations |
currency_name | string | Yes | Currency identifier/name |
package_name | string | No | Callback package identifier |
doc_number | string | No | External document number |
headless | boolean | No | Headless mode flag |
no_printing | boolean | No | Disable printing |
txn_config | object | No | Additional transaction options |
language | string | No | Response localization hint |
Validation notes:
tipsandcashbackcannot both be greater than zero.currency_namemust be supported by deployment.