Defined Fields

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: BRL, USD, EUR or TON
TX ID	05	Yes	Unique transaction identifier
CRC	99	Yes	CRC16-CCITT (always 4 characters, always last)

Field Details

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

Unique merchant/store identifier.

• Format: alphanumeric string
• Maximum length: 32 characters
• Spaces: replaced by _ in the payload, restored on display
• Example: store123 or My_Store

Field 03 - Amount

Payment value in cents (integer).

Note

For BRL, USD, and EUR the value is in cents. For TON, the value is also in cents (1 TON = 100 cents in the protocol). Example: $1,000.00 = 100000

• Format: positive integer as string
• Example: 100000 (= $1,000.00)

Field 04 - Currency

Currency code in ISO 4217 format (or TON).

• Accepted values: BRL, USD, EUR, TON
• Default: BRL

Field 05 - TX ID

Unique transaction identifier. Used for tracking and status queries.

• Format: alphanumeric string
• Maximum length: 32 characters
• Generation: can be provided by the merchant or generated automatically
• Example: tx1709234567

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"