Guia
Cripto (USDT/USDC)
Receba stablecoins em TRON, Ethereum, Polygon ou Solana e decida se o valor fica em stablecoin ou vira reais.
1. Crie a cobrança
Valores em 6 casas decimais (25000000 = 25 USDT). settleAs: KEEP mantém na carteira; CONVERT converte para BRL ao confirmar.
POST /v1/crypto/charges
curl -X POST https://api2.bosspay.io/v1/crypto/charges \
-H "Authorization: Bearer bp_test_SUA_CHAVE" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pedido-9001" \
-d '{ "asset": "USDT", "network": "TRON", "amount": "25000000", "settleAs": "KEEP", "externalId": "9001" }'2. Mostre endereço e valor
A resposta traz o endereço de depósito, a rede e a validade. Oriente o pagador a usar exatamente a rede indicada.
3. Aguarde as confirmações
crypto.received chega quando a transferência atinge as confirmações necessárias. Se expirar, crypto.expired.
4. Cotação de conversão
POST /v1/fx/quotes devolve uma cotação travada por tempo limitado (escopo crypto.convert). A execução da conversão é feita no painel, com 2FA.
Webhooks relevantes
crypto.receivedcrypto.expiredconversion.completedconversion.failedExecução de conversão por API key Em breve