Referência
Cripto e câmbio
Recebimento em stablecoins (USDT/USDC) e cotações BRL ↔ stablecoin. A execução da conversão é feita pelo painel (exige 2FA).
Exige o produto CRYPTO / FX ativo para a empresa em Produção. No Sandbox basta não estar desativado.
POST
/v1/crypto/chargesCria cobrança em stablecoin (endereço + valor)
Escopo crypto.receiveAceita Idempotency-Key
Corpo (JSON)
asset
USDT | USDCPadrão USDT.
network
enumTRON (padrão), ETHEREUM, POLYGON, SOLANA.
amountobrigatório
string | inteiroValor na unidade mínima do ativo (6 casas). Ex.: "25000000" = 25 USDT.
expiresInSeconds
inteiro300 s a 24 h. Padrão 1800.
settleAs
KEEP | CONVERTManter em stablecoin ou converter para BRL ao confirmar.
customer
objetoPagador: name (obrigatório), document (CPF/CNPJ), email, phone.
description
string ≤ 140Descrição.
externalId
string ≤ 80Seu identificador do pedido. Aparece em listagens, filtros e webhooks.
GET
/v1/crypto/chargesLista cobranças cripto
Escopo crypto.read
Parâmetros de consulta
page
inteiroPágina (começa em 1).
pageSize
inteiro ≤ 200Itens por página (padrão 25).
GET
/v1/crypto/charges/:idConsulta cobrança (hash, confirmações)
Escopo crypto.read
GET
/v1/crypto/walletsSaldos das carteiras
Escopo crypto.read
GET
/v1/crypto/historyHistórico de movimentações cripto
Escopo crypto.read
Parâmetros de consulta
page
inteiroPágina (começa em 1).
pageSize
inteiro ≤ 200Itens por página (padrão 25).
POST
/v1/fx/quotesCotação travada BRL ↔ USDT/USDC
Escopo crypto.convert
Corpo (JSON)
from / toobrigatório
BRL | USDT | USDCUm dos lados precisa ser BRL.
amountobrigatório
string | inteiroValor na moeda de origem (unidade mínima).
destination
BALANCE | PIX_OUTPIX_OUT só para conversões em BRL.
GET
/v1/fx/quotes/:idConsulta cotação (validade)
Escopo crypto.convert
GET
/v1/fx/conversionsLista conversões
Escopo crypto.read
Parâmetros de consulta
page
inteiroPágina (começa em 1).
pageSize
inteiro ≤ 200Itens por página (padrão 25).
GET
/v1/fx/conversions/:idConsulta conversão
Escopo crypto.read