الأخطاء
صيغة الأخطاء ورموزها.
تستخدم الأخطاء رموز HTTP المعتادة وصيغة JSON موحدة:
HTTP/1.1 422 Unprocessable Entity
{
"error": {
"code": "validation_failed",
"message": "The amount must be at least 1.",
"fields": { "amount": "The amount must be at least 1." }
}
}| HTTP | الرمز | المعنى |
|---|---|---|
| 400 | invalid_json | محتوى الطلب ليس JSON صالحاً. |
| 401 | unauthenticated / invalid_api_key | المفتاح السري مفقود أو غير صحيح. |
| 403 | ip_not_allowed، merchant_suspended، store_inactive | لا يُسمح باستخدام المفتاح. |
| 404 | not_found | المورد غير موجود. |
| 409 | idempotency_conflict، invalid_state | طلب متعارض. |
| 422 | validation_failed، network_unavailable، limit_reached | مدخلات غير صالحة أو مخالفة لقواعد العمل. |
| 429 | rate_limited | طلبات كثيرة جداً. |
| 5xx | server_error | خطأ من جهتنا. أعد المحاولة بنفس Idempotency-Key. |
تحتاج مساعدة؟ تواصل معنا
آخر تحديث: 17 نوفمبر 2026 م