Crie sua primeira fatura de teste com a API da CrptoX

Configure carteira e chave TEST, consulte métodos de pagamento, crie uma fatura e verifique seu status com a API da CrptoX.

1. Criar conta comercial

Verifique seu e-mail, adicione uma carteira TRON Shasta ativa no modo de teste e crie uma chave TEST. A chave define o ambiente; o endereço da API é o mesmo.

2. Confira os métodos de pagamento disponíveis

Bash / cURL BASH
read -r -s -p 'TEST API key: ' CRPTOX_TEST_KEY
printf '\n'

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $CRPTOX_TEST_KEY" \
  -H 'Accept: application/json' \
  'https://crptox.com/api/v1/payment-methods'

Lista vazia ou merchant_wallet_unavailable: adicione uma carteira ativa na rede e no ambiente da fatura. Uma carteira LIVE não atende uma chave TEST.

3. Crie uma fatura

POST /api/v1/invoices BASH
curl --fail-with-body --silent --show-error \
  -X POST 'https://crptox.com/api/v1/invoices' \
  -H "Authorization: Bearer $CRPTOX_TEST_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{"amount":"1","network":"tron","asset":"USDT","expires_in":1800}'
Criar uma fatura

4. Pague a fatura e consulte o status

Use data.invoice.uuid para abrir a página de pagamento e consultar a fatura. Envie exatamente data.payment.amount em tokens de teste na Shasta e aguarde a confirmação. Tokens de teste não têm valor monetário real.

GET /api/v1/invoices/{uuid} BASH
read -r -p 'data.invoice.uuid: ' CRPTOX_INVOICE_UUID
printf '%s\n' "https://crptox.com/pay/$CRPTOX_INVOICE_UUID"

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $CRPTOX_TEST_KEY" \
  -H 'Accept: application/json' \
  "https://crptox.com/api/v1/invoices/$CRPTOX_INVOICE_UUID"

Entregue o pedido apenas quando data.invoice.status for paid. Um pagamento detectado ou em confirmação ainda não está confirmado definitivamente.

Guarde a chave no servidor. Verifique assinaturas dos webhooks e consulte a fatura com uma chave do mesmo ambiente antes da entrega. Retorno do navegador ou captura de tela não comprova pagamento.

Se a primeira solicitação falhar

  • 401: confira a chave Bearer, a validade e se está ativa. Nunca a publique em mensagens de suporte.
  • Lista vazia ou merchant_wallet_unavailable: adicione uma carteira ativa na rede e no ambiente da fatura. Uma carteira LIVE não atende uma chave TEST.
  • 422: confira error.details e as combinações de rede e token. Em erros de cota, veja o limite compartilhado entre TEST e LIVE. Para 429, reduza as solicitações e respeite o tempo informado.
erros