محیط‌ها

محیط‌ها و Sandbox

crptoX محیط‌های Sandbox و Live را به‌صورت کاملاً جدا ارائه می‌کند تا بتوانید پیش از پردازش پرداخت‌های واقعی، کل فرآیند اتصال و پرداخت را آزمایش کنید.

Sandbox و Live

Sandbox


                            crx_test_...

محیط Sandbox برای توسعه و تست طراحی شده است. درخواست‌هایی که با API Key دارای پیشوند crx_test_ احراز هویت می‌شوند از شبکه‌های آزمایشی پشتیبانی‌شده استفاده می‌کنند و با اطلاعات پرداخت Production تداخلی ندارند.

Live


                            crx_live_...

محیط Live برای پرداخت‌های واقعی است. درخواست‌هایی که با API Key دارای پیشوند crx_live_ احراز هویت می‌شوند از شبکه‌های اصلی فعال و تنظیمات واقعی مرچنت استفاده می‌کنند.

محیط درخواست فقط و فقط از طریق API Key تعیین می‌شود. فیلد environment یا mode را در بدنه درخواست ارسال نکنید.

شبکه‌های Sandbox

پرداخت‌های Sandbox روی شبکه‌های آزمایشی بلاکچین انجام می‌شوند. پیش از ایجاد فاکتور، برای شبکه‌ای که قصد تست آن را دارید یک Sandbox Wallet تعریف کنید.

TRON

Shasta

پرداخت‌های آزمایشی TRON در محیط Sandbox روی شبکه Shasta پردازش می‌شوند.

BSC

BSC Testnet

پرداخت‌های آزمایشی BSC در محیط Sandbox روی شبکه BSC Testnet پردازش می‌شوند.

تست کامل فرآیند پرداخت

1
از بخش Developer پنل مرچنت یک Sandbox API Key ایجاد کنید.
2
در بخش Sandbox Wallets یک کیف پول فعال برای شبکه تست موردنظر خود اضافه کنید.
3
با استفاده از endpoint روش‌های پرداخت، ترکیب‌های network و asset قابل استفاده را دریافت کنید.
4
با API Key دارای پیشوند crx_test_ و یکی از روش‌های پرداخت فعال Sandbox یک فاکتور ایجاد کنید.
5
مقدار موردنیاز از توکن تست را از یک کیف پول روی همان شبکه تست به آدرس پرداخت برگردانده‌شده توسط فاکتور ارسال کنید.
6
crptoX تراکنش بلاکچین را شناسایی می‌کند، وضعیت تأییدها را بررسی می‌کند و وضعیت پرداخت و فاکتور را به‌روزرسانی می‌کند.
7
با دریافت مجدد اطلاعات فاکتور یا پردازش webhookهای مربوطه، نتیجه نهایی پرداخت را بررسی کنید.

مشاهده روش‌های پرداخت فعال

با endpoint روش‌های پرداخت می‌توانید شبکه‌ها و دارایی‌هایی را که در محیط فعلی برای حساب مرچنت شما قابل استفاده هستند دریافت کنید. به این ترتیب نیازی به hard-code کردن روش‌های پرداخت در integration نخواهید داشت.

نمونه BASH

curl https://crptox.com/api/v1/payment-methods \
  -H "Authorization: Bearer crx_test_YOUR_API_SECRET"

Sandbox کاملاً از Live جدا است

کیف پول‌ها، فاکتورها، تراکنش‌های بلاکچین و فعالیت‌های پرداخت در Sandbox از اطلاعات Live جدا هستند. پرداخت روی شبکه تست نمی‌تواند یک فاکتور Live را تسویه کند و پرداخت Live نیز نمی‌تواند یک فاکتور Sandbox را تسویه کند.