پیش از آنکه فروشگاه، پنل بیلینگ یا ربات خود را به پرداخت کریپتو وصل کنید، می‌خواهید کل مسیر را در عمل ببینید: فاکتور ساخته می‌شود، مشتری کوین را انتخاب می‌کند، پرداخت تأیید می‌شود و سیستم شما سفارش را پرداخت‌شده علامت می‌زند. با SnapEX Pay همه این‌ها را می‌توانید بدون ارسال حتی یک کوین انجام دهید.
فاکتور تست چیست
فاکتور تست یک فاکتور معمولی SnapEX Pay است که environment آن برابر test است. همان وضعیت‌ها را طی می‌کند و همان وب‌هوک‌های فاکتور واقعی را می‌فرستد و در هر رویداد data.environment برابر "test" است. موجودی واقعی شما هرگز تغییر نمی‌کند.
کلید API جداگانه‌ای برای تست وجود ندارد: از همان کلید استفاده می‌کنید و فقط یک فیلد در درخواست تغییر می‌کند.
ساخت فاکتور تست از طریق API
"environment": "test" را به درخواست ساخت فاکتور اضافه کنید:
curl -sS -X POST https://pay.snapex.pro/api/v1/merchant/invoices \
-H "Authorization: Bearer <your API key>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Idempotency-Key: order-15-test" \
-d '{
"amount_usd": "15.00",
"environment": "test",
"external_id": "order-15"
}'
کلید باید دسترسی invoices.write داشته باشد. پاسخ، درست مثل فاکتور واقعی، شامل لینک پرداخت است.
یا ساخت آن در پنل فروشنده
در پنل، بخش Invoices را باز کنید و حالت را روی Test بگذارید. فاکتورهایی که آنجا می‌سازید تست هستند و فهرست فقط فاکتورهای تست را نشان می‌دهد، پس هرگز با پرداخت‌های واقعی قاطی نمی‌شوند.
پرداخت آن
لینک پرداخت را باز کنید. صفحه یک نشان Test دارد. هر کوین و شبکه‌ای را انتخاب کنید: صفحه یک آدرس تست (نه آدرس واقعی) نشان می‌دهد و حدود ۱۰ ثانیه بعد پرداخت خودبه‌خود تأیید می‌شود. لازم نیست چیزی ارسال کنید.
در سمت خودتان چه چیزی را بررسی کنید
- تحویل وب‌هوک. endpoint شما رویداد
invoice.paidرا باdata.environment = "test"دریافت می‌کند. بررسی کنید که امضا تأیید شود و تحویل تکراری با همانWebhook-Idسفارش را دو بار پرداخت‌شده علامت نزند. - وضعیت سفارش. سفارش در سیستم شما فقط با
invoice.paidپرداخت‌شده می‌شود. - جدا ماندن تست و واقعی. مطمئن شوید که کد شما پس از رفتن به حالت واقعی رویدادهای تست را نادیده می‌گیرد، یا سفارش‌های تست را جدا نگه می‌دارد.
حالت تست در ماژول‌های آماده
ماژول‌های WHMCS، BILLmanager، WooCommerce، CS-Cart، FOSSBilling، Paymenter و Remnawave حالت تستی دارند که فاکتور تست می‌سازد. در WHMCS تا وقتی این حالت روشن است فقط ادمین‌های واردشده دکمه پرداخت را می‌بینند، در WooCommerce فقط مدیران فروشگاه این روش را می‌بینند؛ در BILLmanager و CS-Cart روش تست را به یک مشتری یا گروه کاربری تست محدود می‌کنید. سفارش بدهید، آن را در صفحه SnapEX Pay بپردازید و بررسی کنید که سفارش پرداخت‌شده شود، سپس حالت تست را خاموش کنید. راهنماهای نصب در pay.snapex.pro این مرحله را برای هر ماژول توضیح می‌دهند.
سپس به حالت واقعی بروید
"environment": "test" را حذف کنید (یا حالت تست را در ماژول خاموش کنید) تا فاکتورهای بعدی واقعی باشند. پرداخت‌های تست هرگز روی سفارش‌های واقعی اعمال نمی‌شوند.
مرجع کامل API: مستندات API SnapEX Pay.