Campos Definidos
Tabela de campos
Seção intitulada “Tabela de campos”| Campo | Tag | Obrigatório | Descrição |
|---|---|---|---|
| Wallet | 01 |
Sim | Endereço TON de destino (10-48 caracteres) |
| Merchant | 02 |
Sim | Identificador do estabelecimento (espaços substituídos por _) |
| Amount | 03 |
Sim | Valor em centavos (inteiro positivo) |
| Currency | 04 |
Sim | Moeda (fixo): USDT |
| TX ID | 05 |
Sim | Identificador único da transação (máx 64 chars) |
| HMAC | 06 |
Não | Assinatura HMAC-SHA256 (16 chars hex) |
| CRC | 99 |
Sim | CRC16-CCITT (sempre 4 caracteres, sempre último) |
Detalhes por campo
Seção intitulada “Detalhes por campo”Campo 01 - Wallet
Seção intitulada “Campo 01 - Wallet”Endereço da carteira TON de destino do pagamento.
- Formato: string alfanumérica com
_e- - Tamanho: 10 a 48 caracteres
- Exemplo:
UQBJ6gU8gh_jRrzYDlfw9cpCwHaSn2mrK4O-1h8CDENehGYJ
Campo 02 - Merchant
Seção intitulada “Campo 02 - Merchant”Identificador único do estabelecimento/comerciante.
- Formato: string alfanumérica
- Tamanho máximo: 32 caracteres
- Espaços: substituídos por
_no payload, restaurados na exibição - Exemplo:
store123ouMinha_Loja
Campo 03 - Amount
Seção intitulada “Campo 03 - Amount”Valor do pagamento em centavos (inteiro).
- Formato: inteiro positivo como string
- Máximo:
10000000(= 100.000,00 USDT) — valores acima são rejeitados pelo servidor - Exemplo:
1000(= 10,00 USDT)
Campo 04 - Currency
Seção intitulada “Campo 04 - Currency”Código da moeda. Atualmente apenas USDT é suportado.
- Valor aceito:
USDT - Padrão:
USDT
Campo 05 - TX ID
Seção intitulada “Campo 05 - TX ID”Identificador único da transação. Usado para rastreamento e consulta de status.
- Formato: string alfanumérica
- Tamanho máximo: 64 caracteres
- Geração: pode ser fornecido pelo comerciante ou gerado automaticamente
- Exemplo:
tx1709234567
Campo 06 - HMAC (opcional)
Seção intitulada “Campo 06 - HMAC (opcional)”Assinatura HMAC-SHA256 para garantir a integridade do payload. Quando presente, o servidor valida que o payload não foi alterado.
- Formato: 16 caracteres hexadecimais (truncado do SHA256)
- Cálculo:
HMAC-SHA256(payload_sem_hmac_sem_crc, chave_secreta)[:16] - Uso: protege contra adulteração de valores (wallet, amount, etc.)
Campo 99 - CRC
Seção intitulada “Campo 99 - CRC”Checksum CRC16-CCITT para validação de integridade.
- Tamanho: sempre 4 caracteres (hexadecimal uppercase)
- Posição: sempre o último campo do payload
- Cálculo: sobre
payload_sem_crc + "9904"