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