یک الگوی اتصال برای هر دو محصول

فاکتور ریالی و پرداخت USDT را با یک API متصل کنید

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

یک قرارداد مشترک؛ دو مسیر پرداخت

API مناسب را انتخاب و همان‌جا بررسی کنید

ساختار احراز هویت، شناسه خارجی، Idempotency و Callback مشترک است؛ فقط جزئیات rail پرداخت تغییر می‌کند.

curl -X POST https://radicalpay-api.rayanpersis.com/v1/invoices \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: visit_8421" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "visit_8421",
    "amount": 480000000,
    "currency": "IRR",
    "callback_url": "https://example.com/webhooks"
  }'
SandboxPOST /v1/invoices201 Created
قرارداد مشترکexternal_idIdempotency-Keycallback_urlمدل خطای مشترکWebhook امضاشده قابل اعتبارسنجی

API یکپارچه

ساخت، مشاهده و لغو فاکتور ریالی یا سفارش USDT با شناسه داخلی کسب‌وکار.

رویدادهای قابل اعتبارسنجی

رویدادهای پرداخت، Refund و تسویه با امضا، timestamp و Retry امن ارسال می‌شوند.

اتصال آماده یا اختصاصی

از WooCommerce و WordPress تا SDK و REST API، مسیر متناسب با تیم خود را انتخاب کنید.

مدل رویداد مشترک

از پرداخت تا فعال‌سازی سرویس

به‌جای وابستگی به یک پاسخ لحظه‌ای، وضعیت نهایی را از Webhook معتبر دریافت و عملیات محصول را به آن متصل کنید.

  • invoice.paid و invoice.expired
  • payment.confirmed و payment.exception
  • refund.approved و settlement.completed
  • Idempotency برای درخواست و مصرف رویداد
مرکز Webhook و Callback

رویداد را مشاهده، عیب‌یابی و دوباره ارسال کنید

تاریخچه تحویل، payload، پاسخ مقصد و تلاش‌های مجدد برای هر دو محصول در یک مرکز عملیاتی دیده می‌شود.

رویدادهای اخیرSandboxProduction
invoice.paid200 OKapi.example.com/radical
payment.confirmed503 Failedbackup.example.com/webhook
امضای HMAC و timestamp جلوگیری از Replay چند endpoint مشاهده request / response
از بدون کدنویسی تا اتصال اختصاصی

افزونه‌ها و ابزارهای توسعه

برای شروع سریع از مسیر اتصال مناسب استفاده کنید؛ برای کنترل بیشتر سراغ SDK یا API بروید.

WooCommerceWordPress Payment LinkWHMCSPHP SDKNode.js SDKPostman CollectionWebhook Tester

چرخه تست تا انتشار

  • کلید و داده مستقل Sandbox
  • تست امضا، Timeout و خطای endpoint
  • Replay رویدادهای انتخابی
  • انتقال کنترل‌شده به Production
مسیر پیشنهادی اتصال

شناخت، محیط آزمایشی، تست و فعال‌سازی کنترل‌شده

گفت‌وگو با تیم فنی