مدفوعات بعملات مستقرة تستحق ثقتك فعلًا
طلب REST واحد يُنشئ الدفعة. نراقب السلسلة، ونطابق المبلغ وعنوان الاستلام، ثم نسلّم Webhook موقّعًا لحظة تسويتها — مع إعادة المحاولة حتى تستجيب نقطة النهاية لديك.
Forypay واجهة API للمطورين لإنشاء مدفوعات USDT والتحقق منها على شبكتي BSC وTRON.
- < 3 ث
- زمن الاكتشاف
- 2
- الشبكات
- تراجع أُسّي
- إعادة محاولة Webhook
pay_8Fq2mZx1LrKd
25.00 USDT
- تم اكتشاف التحويلالكتلة 42,181,905 · 0.8 ث
- تطابق المبلغ والمستلمتطابق تام · 25.00 USDT
- تم التحقق على السلسلةتستقر فورًا · دون انتظار تأكيدات
- تم تسليم Webhookpayment.confirmed · 200 OK
ما تحصل عليه
الجوانب المُرهقة في مدفوعات العملات الرقمية، متكفَّل بها
إعادة تنظيم الكتل، المدفوعات الجزئية، التحويلات المكرّرة، نقاط النهاية المتوقّفة. أنماط الفشل التي لا تظهر إلا في الإنتاج هي ما بنينا هذا النظام حوله.
طلب واحد لإنشاء دفعة
أرسل معرّف الطلب والمبلغ والمستلم والشبكة بطلب POST. تستلم معرّف الدفعة ووقت انتهاء الصلاحية — دون أي تعامل مع السلسلة من جانبك.
Webhooks موقّعة مع إعادة المحاولة
تُسلَّم أحداث payment.detected و payment.confirmed و payment.expired مع توقيع HMAC، وتُعاد المحاولة بتراجع أُسّي حتى تُرجع نقطة النهاية لديك رمز 2xx.
BSC و TRON في واجهة واحدة
تحويلات توكن BEP-20 و TRC-20 خلف واجهة واحدة، مع مُهايئات لكل شبكة تتولّى الفروق في صيغة العناوين وفكّ ترميز السجلات.
تُسوّى لحظة اكتشافها
التحويل الذي يظهر في سجل السلسلة مقبول من الشبكة فعلًا، فيُسوّى فورًا. لا تأكيدات ننتظرها، ولا حدّ لضبطه، ولا شيء يُسلَّم متأخرًا.
المبلغ المحدد بالضبط فقط
لا تُسوّى الدفعة إلا بتحويلٍ يطابق المبلغ المتوقّع بالضبط — لا أكثر ولا أقل. الدفع الناقص والزائد والمكرّر لا يُعتدّ به تلقائيًا أبدًا، بل يُسجَّل للمعالجة اليدوية، وتنتهي صلاحية الدفعات غير المسدَّدة تلقائيًا.
آمن للتكرار بحكم التصميم
أرسل ترويسة Idempotency-Key، فيُرجع طلب الإنشاء المُعاد الدفعة الأصلية بدل إنشاء نسخة مكرّرة — آمن للاستدعاء من شبكة غير موثوقة.
التكامل
نقطتا نهاية ومعالج Webhook واحد
لا حزمة SDK للتثبيت ولا عقدة سلسلة لتشغيلها. إن كانت منظومتك تستطيع إرسال طلب HTTPS واستقباله، فستنتهي في بعد ظهيرة واحد.
- 01
أنشئ الدفعة
أخبرنا بالطلب والتوكن وعنوان الاستلام والمبلغ المتوقّع. التحويل المطابق يُسوّيها من تلقاء نفسه — دون أي حدّ لضبطه.
- 02
نحن نراقب السلسلة
يطابق عاملٌ التحويلات الواردة مع المستلم والمبلغ المتوقّعين، ويُسوّي الدفعة لحظة تطابقهما.
- 03
تستلم Webhook موقّعًا
تحقّق من توقيع HMAC، وضع علامة الدفع على الطلب، وامضِ في عملك. التسليمات الفاشلة تُعاد بتراجع أُسّي حتى تستجيب نقطة النهاية لديك.
curl https://your-host/api/v1/payments \
-H "Authorization: Bearer $FP_API_KEY" \
-H "Idempotency-Key: order-1042" \
-H "Content-Type: application/json" \
-d '{
"order_id": "ORDER-1042",
"network": "bsc",
"receiver": "0x2f1a…9c3e",
"amount": "25.00",
"expires_in": 1800
}'POST /your/webhook
Content-Type: application/json
X-Forypay-Event: payment.confirmed
X-Forypay-Delivery: whk_3Kd9vQ2mTz
X-Forypay-Timestamp: 1755820800
X-Forypay-Signature: sha256=6f1b…a92c
{
"event": "payment.confirmed",
"data": {
"payment_id": "pay_8Fq2mZx1LrKd",
"order_id": "ORDER-1042",
"network": "bsc",
"token": "USDT",
"amount": "25.00",
"transaction_hash": "0x9d4c…7b21",
"status": "CONFIRMED"
}
}تحقّق من دفعتك الأولى اليوم
أنشئ مشروعًا، وولّد مفتاح اختبار، وشاهد تحويلًا على شبكة الاختبار يُسوّى لحظة اكتشافه. دون بطاقة.