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
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
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}'
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.
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.