Die erste Testrechnung mit der CrptoX API erstellen

Konfigurieren Sie TEST-Wallet und API-Schlüssel, rufen Sie Zahlungsarten ab, erstellen Sie eine Rechnung und prüfen Sie ihren Status mit der CrptoX API.

1. Händlerkonto erstellen

Bestätigen Sie Ihre E-Mail, aktivieren Sie eine TRON-Shasta-Wallet im Testmodus und erstellen Sie einen TEST-Schlüssel. Der Schlüssel bestimmt die Umgebung; die API-Adresse bleibt gleich.

2. Verfügbare Zahlungsarten prüfen

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'

Leere Liste oder merchant_wallet_unavailable: Aktivieren Sie eine Wallet im Netzwerk und in der Umgebung der Rechnung. Eine LIVE-Wallet passt nicht zu einem TEST-Schlüssel.

3. Rechnung erstellen

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}'
Rechnung erstellen

4. Rechnung bezahlen und Status prüfen

Öffnen Sie mit data.invoice.uuid die Zahlungsseite und fragen Sie die Rechnung ab. Senden Sie genau data.payment.amount mit Shasta-Testtoken und warten Sie auf die Bestätigung. Testtoken haben keinen echten Geldwert.

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"

Liefern Sie erst aus, wenn data.invoice.status den Wert paid hat. Erkannte Zahlungen oder laufende Bestätigungen sind noch nicht endgültig bestätigt.

Bewahren Sie den API-Schlüssel auf Ihrem Server auf. Prüfen Sie Webhook-Signaturen und den Rechnungsstatus mit einem Schlüssel derselben Umgebung vor der Auslieferung. Browser-Rückkehr und Screenshots sind kein Zahlungsnachweis.

Wenn die erste Anfrage fehlschlägt

  • 401: Prüfen Sie Bearer-Schlüssel, Ablaufdatum und Aktivierung. Veröffentlichen Sie den Schlüssel nicht in Support-Nachrichten.
  • Leere Liste oder merchant_wallet_unavailable: Aktivieren Sie eine Wallet im Netzwerk und in der Umgebung der Rechnung. Eine LIVE-Wallet passt nicht zu einem TEST-Schlüssel.
  • 422: Prüfen Sie error.details und unterstützte Netzwerk-Token-Kombinationen. Bei Kontingentfehlern prüfen Sie das gemeinsame TEST/LIVE-Limit. Bei 429 reduzieren Sie Anfragen und beachten die Wartezeit.
Fehler