API المدفوعات
توثيق شامل لجميع endpoints المدفوعات في منصة مُلكم
واجهة برمجة المدفوعات تتيح لك انشاء عمليات دفع، ادارة الاشتراكات، واستقبال اشعارات الدفع عبر Tap Payments.
create-tap-charge
انشاء عملية دفع جديدة.
Method: POST
URL: /functions/v1/create-tap-charge
Body:
Response (200):
الحالات:
| الحالة | الوصف |
|---|---|
INITIATED | تم انشاء الدفعة، بانتظار الدفع |
CAPTURED | تم الدفع بنجاح |
FAILED | فشل الدفع |
CANCELLED | تم الالغاء |
create-tap-charge-with-token
دفع باستخدام بطاقة محفوظة (tokenized).
Method: POST
URL: /functions/v1/create-tap-charge-with-token
Body:
tap-webhook
يستقبل اشعارات حالة الدفع من Tap تلقائيًا. لا تحتاج استدعاء هذا الـ endpoint يدويًا.
Method: POST
URL: /functions/v1/tap-webhook
يتم تحديث حالة الطلب في قاعدة البيانات تلقائيًا عند استقبال الـ webhook.
الاحداث المدعومة:
| الحدث | الوصف |
|---|---|
CAPTURED | تم الدفع بنجاح |
FAILED | فشل الدفع |
REFUNDED | تم الاسترداد |
create-subscription-charge
انشاء اشتراك شهري/سنوي جديد.
Method: POST
URL: /functions/v1/create-subscription-charge
Body:
test-tap-connection
اختبار صحة مفاتيح API لـ Tap.
Method: POST
URL: /functions/v1/test-tap-connection
Body:
Response (200):