Cripto (USDT)
Converte parte do seu saldo em reais para USDT e envia direto para uma carteira. O valor sai do saldo disponível na hora em que a conversão é criada; se o envio falhar, volta inteiro.
Para converter e guardar USDT na sua carteira StacePay, sem enviar para fora, use Carteiras e conversão. Esta rota continua disponível para quem já integra o envio direto.
Criptomoedas disponíveis
| Moeda | Redes | Origem |
|---|---|---|
USDT (Tether) | TRC20 (Tron) | Saldo em BRL |
A lista vale para o momento da consulta. Para saber em tempo real, use:
{
"object": "list",
"data": [
{
"object": "crypto_asset",
"coin": "USDT",
"name": "Tether",
"networks": ["TRC20"],
"source_currency": "BRL",
"available": true
}
]
}Cotação
Mostra quanto USDT chega na carteira, já descontadas a taxa StacePay e as taxas de conversão e envio da rede. Não debita nada.
| Campo | Tipo | Descrição | |
|---|---|---|---|
amount | integer | obrigatório | Valor em centavos de real a converter. |
curl -X POST https://stacepay.com.br/api/v1/crypto/quote \
-H "Authorization: Bearer nvx_live_..." \
-H "Content-Type: application/json" \
-d '{"amount": 50000}'{
"object": "crypto_quote",
"coin": "USDT",
"currency": "BRL",
"amount": 50000,
"fee_amount": 1000,
"net_amount": 49000,
"amount_usdt": "84.12",
"rate": "5.4100"
}A cotação muda com o dólar. O valor final é calculado de novo no momento da conversão. Se o valor não cobrir as taxas, a resposta é 422 below_min.
Criar conversão
Use um Idempotency-Key. KYC aprovado é obrigatório.
| Campo | Tipo | Descrição | |
|---|---|---|---|
amount | integer | obrigatório | Valor em centavos de real, debitado do saldo disponível. |
network | string | obrigatório | Rede da carteira de destino. Hoje: "TRC20". |
wallet_address | string | obrigatório | Endereço da carteira que recebe o USDT. |
curl -X POST https://stacepay.com.br/api/v1/crypto/conversions \
-H "Authorization: Bearer nvx_live_..." \
-H "Idempotency-Key: cripto-0001" \
-H "Content-Type: application/json" \
-d '{"amount": 50000, "network": "TRC20", "wallet_address": "TXYZ..."}'{
"object": "crypto_conversion",
"id": "CR261110A1B2C3",
"status": "processing",
"coin": "USDT",
"network": "TRC20",
"currency": "BRL",
"amount": 50000,
"fee_amount": 1000,
"net_amount": 49000,
"wallet_address": "TXYZ...",
"amount_usdt": "84.12",
"tx_hash": null,
"failure_reason": null,
"created_at": "2026-11-10T15:20:00-03:00"
}Listar e buscar
Consulte a conversão até o status final. Quando concluída, tx_hash traz o hash da transação na rede.
Status possíveis
| Status | Significado |
|---|---|
pending | Criada, aguardando envio ao parceiro. |
processing | Em conversão e envio para a carteira. |
completed | USDT enviado. Veja tx_hash. |
failed | Falhou; o valor em reais volta ao saldo. Motivo em failure_reason. |
canceled | Cancelada; o valor volta ao saldo. |