التوثيق

API المدفوعات

توثيق شامل لجميع endpoints المدفوعات في منصة مُلكم

واجهة برمجة المدفوعات تتيح لك انشاء عمليات دفع، ادارة الاشتراكات، واستقبال اشعارات الدفع عبر Tap Payments.

create-tap-charge

انشاء عملية دفع جديدة.

Method: POST

URL: /functions/v1/create-tap-charge

Body:

{
  "amount": 100,
  "currency": "SAR",
  "customer": {
    "first_name": "Ahmed",
    "last_name": "Mohammed",
    "email": "ahmed@example.com",
    "phone": { "country_code": "966", "number": "500000000" }
  },
  "source": { "id": "src_card" },
  "redirect": { "url": "https://yourstore.mollkom.com/checkout/success" },
  "metadata": { "order_id": "ORD-001" }
}

Response (200):

{
  "id": "chg_TS01A1234567890",
  "status": "INITIATED",
  "amount": 100,
  "currency": "SAR",
  "transaction": {
    "url": "https://checkout.payments.tap.company/..."
  }
}

الحالات:

الحالةالوصف
INITIATEDتم انشاء الدفعة، بانتظار الدفع
CAPTUREDتم الدفع بنجاح
FAILEDفشل الدفع
CANCELLEDتم الالغاء

create-tap-charge-with-token

دفع باستخدام بطاقة محفوظة (tokenized).

Method: POST

URL: /functions/v1/create-tap-charge-with-token

Body:

{
  "amount": 50,
  "currency": "SAR",
  "token": "tok_XXXXXXXXXXXX",
  "order_id": "ORD-002"
}

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:

{
  "plan_id": "plan_basic_monthly",
  "store_id": "uuid-here"
}

test-tap-connection

اختبار صحة مفاتيح API لـ Tap.

Method: POST

URL: /functions/v1/test-tap-connection

Body:

{
  "secret_key": "sk_live_XXXXX"
}

Response (200):

{
  "success": true,
  "message": "Connection successful"
}

On this page