Defined Fields
Field Table
Section titled “Field Table”| Field | Tag | Required | Description |
|---|---|---|---|
| Wallet | 01 | Yes | Destination TON address (10-48 characters) |
| Merchant | 02 | Yes | Merchant identifier (spaces replaced by _) |
| Amount | 03 | Yes | Value in cents (positive integer) |
| Currency | 04 | Yes | Currency (fixed): USDT |
| TX ID | 05 | Yes | Unique transaction identifier (max 64 chars) |
| HMAC | 06 | No | HMAC-SHA256 signature (16 hex chars) |
| CRC | 99 | Yes | CRC16-CCITT (always 4 characters, always last) |
Field Details
Section titled “Field Details”Field 01 - Wallet
Section titled “Field 01 - Wallet”Destination TON wallet address for the payment.
- Format: alphanumeric string with
_and- - Length: 10 to 48 characters
- Example:
UQBJ6gU8gh_jRrzYDlfw9cpCwHaSn2mrK4O-1h8CDENehGYJ
Field 02 - Merchant
Section titled “Field 02 - Merchant”Unique merchant/store identifier.
- Format: alphanumeric string
- Maximum length: 32 characters
- Spaces: replaced by
_in the payload, restored on display - Example:
store123orMy_Store
Field 03 - Amount
Section titled “Field 03 - Amount”Payment value in cents (integer).
- Format: positive integer as string
- Maximum:
10000000(= 100,000.00 USDT) — higher values are rejected by the server - Example:
1000(= 10.00 USDT)
Field 04 - Currency
Section titled “Field 04 - Currency”Currency code. Only USDT is currently supported.
- Accepted value:
USDT - Default:
USDT
Field 05 - TX ID
Section titled “Field 05 - TX ID”Unique transaction identifier. Used for tracking and status queries.
- Format: alphanumeric string
- Maximum length: 64 characters
- Generation: can be provided by the merchant or generated automatically
- Example:
tx1709234567
Field 06 - HMAC (optional)
Section titled “Field 06 - HMAC (optional)”HMAC-SHA256 signature to guarantee payload integrity. When present, the server validates that the payload was not altered.
- Format: 16 hexadecimal characters (truncated from SHA256)
- Calculation:
HMAC-SHA256(payload_without_hmac_without_crc, secret_key)[:16] - Use: protects against tampering of values (wallet, amount, etc.)
Field 99 - CRC
Section titled “Field 99 - CRC”CRC16-CCITT checksum for integrity validation.
- Length: always 4 characters (uppercase hexadecimal)
- Position: always the last field in the payload
- Calculation: over
payload_without_crc + "9904"