التحقّق من حالة الدفع
أكّد النتيجة النهائيّة دائمًا على خادمك قبل تنفيذ أيّ طلب — لا تثق بتحويل المتصفّح وحده أبدًا.
بعد أن يُكمل العميل الدفع (أو يلغيه) ويعود إلى 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 المُعاد مع طلبك، وأكّد المبلغ، وعندها فقط اعتبر الطلب مدفوعًا. هذا يمنع التلاعب عبر التحويل.