StacePay Documentação da API / Cripto (USDT)
Markdown

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

MoedaRedesOrigem
USDT (Tether)TRC20 (Tron)Saldo em BRL

A lista vale para o momento da consulta. Para saber em tempo real, use:

GET/crypto/assets
{
  "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.

POST/crypto/quote
CampoTipoDescrição
amountintegerobrigatórioValor 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

POST/crypto/conversions

Use um Idempotency-Key. KYC aprovado é obrigatório.

CampoTipoDescrição
amountintegerobrigatórioValor em centavos de real, debitado do saldo disponível.
networkstringobrigatórioRede da carteira de destino. Hoje: "TRC20".
wallet_addressstringobrigatórioEndereç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

GET/crypto/conversions?limit=20&offset=0
GET/crypto/conversions/{id}

Consulte a conversão até o status final. Quando concluída, tx_hash traz o hash da transação na rede.

Status possíveis

StatusSignificado
pendingCriada, aguardando envio ao parceiro.
processingEm conversão e envio para a carteira.
completedUSDT enviado. Veja tx_hash.
failedFalhou; o valor em reais volta ao saldo. Motivo em failure_reason.
canceledCancelada; o valor volta ao saldo.