بدء الدفع

أنشئ دفعة، ثمّ حوّل عميلك إلى رابط الدفع الآمن المُعاد.

POST {base_url}/payment/create

الترويسة: Authorization: Bearer {access_token}

جسم الطلب

المُعامل	النوع	الوصف
`amount` مطلوب	decimal	المبلغ المطلوب تحصيله، مقرَّبًا لخانتين عشريّتين.
`currency` مطلوب	string	رمز العملة بأحرف كبيرة (Alpha-3)، مثل `USD`.
`return_url` مطلوب	string	حيث يعود العميل بعد دفعة ناجحة.
`cancel_url` اختياريّ	string	حيث يعود العميل إن ألغى.
`custom` اختياريّ	string	مرجعك/معرّف معاملتك الخاصّ، يُعاد إليك لاحقًا.

مثال طلب

curl -X POST {base_url}/payment/create \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "currency": "USD",
    "return_url": "https://your-site.com/success",
    "cancel_url": "https://your-site.com/cancel",
    "custom": "ORDER-123456"
  }'

نجاح — 200 OK

{
  "message": { "code": 200, "success": ["CREATED"] },
  "data": {
    "token": "2zMRmT3KeYT2BWMAyGhqEfuw4tOYOfGX…",
    "payment_url": "{base_url}/user/authentication/form/2zMRmT3KeYT2BWMAyGhqEfuw…"
  },
  "type": "success"
}

➡️ حوّل عميلك إلى data.payment_url لإتمام الدفع على ZovoPay. بعد الدفع، يعود إلى return_url لديك.

خطأ — 403

{
  "message": { "code": 403, "error": ["Requested with invalid token!"] },
  "data": [],
  "type": "error"
}