رموز الاستجابة
كل ردّ يشترك في نفس المظروف. اقرأ type وmessage.code لتفريع منطقك.
مظروف الاستجابة
{
"message": { "code": 200, "success": ["SUCCESS"] },
"data": { },
"type": "success"
}
عند الإخفاق، يحمل message مصفوفة error بدل success، وtype="error":
{
"message": { "code": 400, "error": ["Invalid secret ID"] },
"data": [],
"type": "error"
}
رموز الحالة
| الرمز | المعنى | متى |
|---|---|---|
| 200 | OK / SUCCESS / CREATED | نجح الطلب. |
| 400 | Bad Request | مفاتيح غير صالحة أو وسائط مشوّهة (مثل client/secret خاطئ). |
| 401 | Unauthorized | access token ناقص أو غير صالح. |
| 403 | Forbidden | token منتهٍ أو غير صالح لهذا الإجراء. |
| 422 | Unprocessable | حقل مطلوب ناقص أو غير صالح (amount، currency، return_url). |
| 500 | Server Error | حدث خطأ من طرفنا — أعد المحاولة قريبًا. |