ZovoPay توثيق API التاجر
API الشركة احصل على مفاتيح API

التحقّق من حالة الدفع

أكّد النتيجة النهائيّة دائمًا على خادمك قبل تنفيذ أيّ طلب — لا تثق بتحويل المتصفّح وحده أبدًا.

بعد أن يُكمل العميل الدفع (أو يلغيه) ويعود إلى return_url، تحقّق من النتيجة. الدفعة المؤكَّدة تُعيد المعاملة وبيانات الدافع، مع إرجاع المرجع custom الذي أرسلته:

نجاح — 200 OK

{
  "message": { "code": 200, "success": ["SUCCESS"] },
  "data": {
    "token": "2zMRmT3KeYT2BWMAyGhqEfuw4tOYOfGX…",
    "trx_id": "BP2c7sAvw75MTlrP",
    "payer": {
      "username": "testuser",
      "email": "user@example.com"
    },
    "custom": "ORDER-123456"
  },
  "type": "success"
}

حقول الاستجابة

الحقلالوصف
trx_idمعرّف معاملة ZovoPay — خزّنه للمطابقة.
customالمرجع الذي أرسلته عند إنشاء الدفعة (مثل معرّف طلبك).
payerالبيانات الأساسيّة للعميل الدافع.
🔒 طابِق الـcustom المُعاد مع طلبك، وأكّد المبلغ، وعندها فقط اعتبر الطلب مدفوعًا. هذا يمنع التلاعب عبر التحويل.