Créez votre première facture de test avec l’API CrptoX

Configurez un portefeuille et une clé TEST, listez les moyens de paiement, créez une facture et vérifiez son statut avec l’API CrptoX.

1. Créer un compte marchand

Vérifiez votre e-mail, ajoutez un portefeuille TRON Shasta actif en mode test et créez une clé TEST. La clé détermine l’environnement ; l’API conserve le même domaine.

2. Vérifiez les moyens de paiement disponibles

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'

Liste vide ou merchant_wallet_unavailable : activez un portefeuille sur le même réseau et dans le même environnement que la facture. Un portefeuille LIVE ne sert pas une clé TEST.

3. Créez une facture

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}'
Créer une facture

4. Payez la facture et vérifiez son statut

Utilisez data.invoice.uuid pour ouvrir la page de paiement et consulter la facture. Envoyez exactement data.payment.amount en jetons de test sur Shasta, puis attendez la confirmation. Ces jetons n’ont aucune valeur monétaire réelle.

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"

Livrez uniquement quand data.invoice.status vaut paid. Un paiement détecté ou en cours de confirmation n’est pas encore définitivement confirmé.

Gardez la clé API côté serveur. Vérifiez la signature des webhooks et relisez la facture avec une clé du même environnement avant de livrer. Un retour du navigateur ou une capture ne prouve pas le paiement.

Si la première requête échoue

  • 401 : vérifiez la clé Bearer, sa validité et son activation. Ne la publiez jamais dans un message d’assistance public.
  • Liste vide ou merchant_wallet_unavailable : activez un portefeuille sur le même réseau et dans le même environnement que la facture. Un portefeuille LIVE ne sert pas une clé TEST.
  • 422 : consultez error.details et les combinaisons réseau/jeton. Pour le quota, vérifiez l’abonnement partagé entre TEST et LIVE. Pour 429, ralentissez et respectez le délai indiqué.
les erreurs