أنشئ أول فاتورة اختبار باستخدام API CrptoX

جهّز محفظة ومفتاح TEST، واعرض طرق الدفع، ثم أنشئ فاتورة وتحقق من حالتها عبر API CrptoX.

1. إنشاء حساب تاجر

وثّق بريدك وأضف محفظة TRON Shasta نشطة في وضع الاختبار وأنشئ مفتاح TEST. المفتاح يحدد البيئة ولا يوجد نطاق منفصل لواجهة الاختبار.

2. تحقق من طرق الدفع المتاحة

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'

قائمة فارغة أو merchant_wallet_unavailable: أضف محفظة نشطة في بيئة الفاتورة وشبكتها. محفظة LIVE لا تعمل مع مفتاح TEST.

3. أنشئ فاتورة

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}'
إنشاء فاتورة

4. ادفع الفاتورة وتحقق من حالتها

استخدم data.invoice.uuid لفتح صفحة الدفع واستعلام الفاتورة. أرسل المبلغ data.payment.amount بالضبط بعملات اختبار على Shasta وانتظر تأكيد الشبكة. عملات الاختبار لا قيمة مالية حقيقية لها.

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"

نفّذ الطلب عندما تكون data.invoice.status هي paid فقط. اكتشاف الدفع أو كونه قيد التأكيد لا يعني التأكيد النهائي.

احتفظ بالمفتاح على الخادم. تحقق من توقيع الويب هوك واستعلم الفاتورة بمفتاح البيئة نفسها قبل التنفيذ. عودة المتصفح أو صورة الإيصال لا تثبت الدفع.

إذا فشل الطلب الأول

  • 401: تحقق من مفتاح Bearer وصلاحيته وتفعيله. لا تنشره في رسائل الدعم العامة.
  • قائمة فارغة أو merchant_wallet_unavailable: أضف محفظة نشطة في بيئة الفاتورة وشبكتها. محفظة LIVE لا تعمل مع مفتاح TEST.
  • 422: راجع error.details وتركيبات الشبكة والعملة. عند خطأ الحصة، راجع اشتراكك المشترك بين TEST وLIVE. عند 429، قلل الطلبات وانتظر المدة المحددة.
أخطاء