Developers

واجهات API متسقة عبر المنصة.

واجهات REST موجّهة نحو الموارد وقابلة للتنبؤ، بحمولات JSON ومفاتيح عدم تكرار وأخطاء واضحة — الأعراف نفسها عبر كل منتج.

احصل على مفاتيح APIتحدّث إلينا

تُرسَل جميع الطلبات عبر HTTPS إلى api.gatetopay.com ويجري توثيقها بمفتاح API من نوع bearer. استخدم مفاتيح الاختبار مقابل البيئة التجريبية والمفاتيح الحية في الإنتاج — السطح مطابق.

مجموعات API.

/v1/cards

الإصدار

أنشئ البطاقات والضوابط والرموز وأدِرها.

/v1/accounts

الحسابات

افتح الحسابات واحمل الأرصدة واقرأ كشوف الحساب.

/v1/payments

خدمات القبول

اقبل المدفوعات عبر الإنترنت وحضوريًا.

/v1/payouts

حركة الأموال

مدفوعات مفردة ومجمّعة عبر القنوات.

/v1/transactions

المعالجة

التفويض والضوابط والمطابقة.

/v1/webhooks

Webhooks

اشترك في أحداث المنصة.

المصادقة

مرّر مفتاح API الخاص بك كرمز bearer في كل طلب. احتفظ بالمفاتيح السرية على الخادم.

طلب موثّق
curl https://api.gatetopay.com/v1/accounts \
  -H "Authorization: Bearer $API_KEY"

إنشاء دفعة

أرسل الأموال إلى بطاقة أو حساب أو محفظة. استخدم مفتاح عدم تكرار لإعادة المحاولة بأمان.

POST /v1/payouts
curl https://api.gatetopay.com/v1/payouts \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: 9d1c7e2b" \
  -d '{
    "amount": 25000,
    "currency": "JOD",
    "destination": { "type": "cliq", "alias": "AHMAD123" }
  }'

الأسئلة الشائعة.

هل واجهة API في البيئة التجريبية مطابقة للإنتاج؟+

نعم — نقاط النهاية والحمولات نفسها. لا يختلف سوى مفتاح API وحركة الأموال الأساسية.

كيف تُمثَّل المبالغ؟+

بأصغر وحدة عملة (مثل الفلس للدينار الأردني) كأعداد صحيحة، لتجنّب مشكلات الفاصلة العائمة.

جاهز للتكامل؟

أنشئ المفاتيح واستكشف نقاط النهاية في البيئة التجريبية.

احصل على مفاتيح API