Developers
أحداث لحظية، تصل إليك.
اشترك في أحداث المنصة — استُخدمت بطاقة، سُوّيت دفعة، قُيّد حساب — وتفاعل معها لحظيًا.
سجّل نقطة نهاية، واختر الأحداث التي تهمك، وترسل Gate to Pay حمولة JSON موقّعة عبر POST كلما وقعت. تحقّق من التوقيع لتأكيد الأصالة.
الأحداث الشائعة.
card.authorized
طُلب تفويض بطاقة أو تمت الموافقة عليه.
payout.settled
وصلت دفعة إلى وجهتها.
account.credited
وصلت أموال إلى حساب.
payment.captured
جرى تحصيل دفعة مقبولة.
transaction.declined
رُفضت معاملة بواسطة القواعد أو المُصدِر.
settlement.completed
اكتملت دفعة تسوية.
مثال على الحمولة
يشترك كل حدث في غلاف يحوي id وtype وكائن data.
POST إلى نقطة النهاية الخاصة بك
{
"id": "evt_2b9f1a",
"type": "payout.settled",
"created": 1789200000,
"data": {
"payout": "po_7c4e",
"amount": 25000,
"currency": "JOD",
"status": "settled"
}
}تحقّق من التوقيع
يتضمن كل طلب ترويسة توقيع. احسب HMAC للجسم الخام باستخدام مفتاح التوقيع الخاص بك وقارن.
- استخدم الجسم الخام للطلب، لا JSON المُحلّل
- ارفض الطلبات الأقدم من بضع دقائق
- أعِد 2xx بسرعة وعالج الطلب بشكل غير متزامن