الأخطاء

صيغة الأخطاء ورموزها.

تستخدم الأخطاء رموز 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الرمزالمعنى
400invalid_jsonمحتوى الطلب ليس JSON صالحاً.
401unauthenticated / invalid_api_keyالمفتاح السري مفقود أو غير صحيح.
403ip_not_allowed، merchant_suspended، store_inactiveلا يُسمح باستخدام المفتاح.
404not_foundالمورد غير موجود.
409idempotency_conflict، invalid_stateطلب متعارض.
422validation_failed، network_unavailable، limit_reachedمدخلات غير صالحة أو مخالفة لقواعد العمل.
429rate_limitedطلبات كثيرة جداً.
5xxserver_errorخطأ من جهتنا. أعد المحاولة بنفس Idempotency-Key.
تحتاج مساعدة؟ تواصل معنا آخر تحديث: 17 نوفمبر 2026 م