ساخت اولین فاکتور سندباکس با API کریپتوکس

با کیف پول و کلید TEST شروع کنید، روش‌های پرداخت را بگیرید، فاکتور بسازید و وضعیت پرداخت را با API کریپتوکس بررسی کنید.

1. ساخت حساب پذیرنده

ایمیل را تأیید کنید، در حالت سندباکس کیف پول فعال TRON Shasta بسازید و کلید TEST بگیرید. حالت اجرا از کلید مشخص می‌شود؛ آدرس جداگانه‌ای برای API سندباکس وجود ندارد.

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 شد سفارش را تحویل دهید. وضعیت شناسایی‌شده یا در حال تأیید هنوز تأیید نهایی نیست.

کلید API را فقط روی سرور نگه دارید. پیش از تحویل سفارش امضای وب‌هوک را بررسی کنید و با کلید همان محیط وضعیت فاکتور را بگیرید. بازگشت مرورگر یا تصویر رسید، تأیید پرداخت نیست.

اولین درخواست خطا داد؟

  • ۴۰۱: کلید Bearer، اعتبار و فعال بودن آن را بررسی کنید. کلید را در پیام‌های عمومی پشتیبانی نفرستید.
  • فهرست خالی یا merchant_wallet_unavailable: کیف پول فعال در محیط و شبکه فاکتور ثبت کنید. کیف پول LIVE برای کلید TEST استفاده نمی‌شود.
  • ۴۲۲: error.details و ترکیب مجاز شبکه و توکن را بررسی کنید. برای خطای سهمیه، ظرفیت مشترک TEST و LIVE را ببینید. برای ۴۲۹ با فاصله اعلام‌شده دوباره تلاش کنید.
خطاها