رموز الأخطاء

كل رفض مشكلةٌ فيها رمز آلي code وحالة HTTP ورابط type إلى صفحتها هنا. وفي الاستدعاءات التي توقّع أنيس ردودها يكون الرفض موقَّعًا أيضًا — انظر التحقق من الردود. ابنِ منطقك على code — لا على العنوان أو التفاصيل، فهي مكتوبة للناس وتصل دائمًا بالإنجليزية. ولكل رمز صفحة هنا بالعربية أيضًا.

يجيب العمود الأخير عن أول سؤال عند رفض طلب شراء: هل تمّ الشراء؟ هذا الاستدعاء لم يشترِ شيئًا: عالج السبب ثم أرسل طلب شراء جديدًا بمعرّف عملية جديد — لكن إن كنت تستأنف طلبًا نتيجته غير معروفة، فالرفض غير الموسوم بـ Idempotency-Replayed لا يخبرك شيئًا عن ذلك الطلب: واصل استئنافه. قد يكتمل: أعد إرسال الطلب نفسه بمعرّف العملية نفسه — لا بمعرّف جديد أبدًا، فقد يُشترى مرتين. لا يُرجَع عند الشراء أبدًا: هذا الخطأ يأتي من استدعاءات أخرى فقط.

المفاتيح والتواقيع

لم تقبل أنيس طريقة توقيع الاستدعاء.

الخطأ	الرمز	الحالة	إن كان طلب شراء
بيانات اعتماد غير صالحة	`invalid_credentials`	401	لم يشترِ شيئًا — ربما اشترت نسخة سابقة: استأنف بالمعرّف نفسه
انتهت صلاحية التوقيع	`signature_expired`	401	لم يشترِ شيئًا — ربما اشترت نسخة سابقة: استأنف بالمعرّف نفسه
بصمة محتوى غير صالحة	`invalid_content_digest`	400	هذا الاستدعاء لم يشترِ شيئًا
استدعاء موقّع غير سليم البنية	`malformed_signed_request`	400	لم يشترِ شيئًا — ربما اشترت نسخة سابقة: استأنف بالمعرّف نفسه
اكتُشف تكرار	`replay_detected`	409	قد يكتمل — استأنف بالمعرّف نفسه

الصلاحيات والحساب

الاستدعاء موقَّع توقيعًا صحيحًا لكنه غير مسموح الآن.

الخطأ	الرمز	الحالة	إن كان طلب شراء
عنوان المصدر غير مسموح	`source_ip_not_allowed`	403	هذا الاستدعاء لم يشترِ شيئًا
صلاحية غير كافية	`insufficient_scope`	403	لم يشترِ شيئًا — ربما اشترت نسخة سابقة: استأنف بالمعرّف نفسه
الحساب غير مخوَّل	`binding_not_authorized`	403	هذا الاستدعاء لم يشترِ شيئًا
المحفظة معطّلة	`wallet_disabled`	409	هذا الاستدعاء لم يشترِ شيئًا
انتهت صلاحية المحفظة	`wallet_expired`	409	هذا الاستدعاء لم يشترِ شيئًا
يلزم اشتراك أعمال	`business_subscription_required`	409	هذا الاستدعاء لم يشترِ شيئًا
الحساب غير فعّال	`account_inactive`	403	هذا الاستدعاء لم يشترِ شيئًا
لا يمكن إلغاء المفتاح	`key_not_revocable`	409	لا يُرجَع عند الشراء أبدًا
لا يمكن إزالة العنوان	`network_not_removable`	409	لا يُرجَع عند الشراء أبدًا

الاستدعاء نفسه

شيء في الاستدعاء غير موجود أو يخالف قاعدة.

الخطأ	الرمز	الحالة	إن كان طلب شراء
لم يُتحقق من العنوان	`webhook_endpoint_unverified`	409	لا يُرجَع عند الشراء أبدًا
عنوان الإشعارات مرفوض	`webhook_endpoint_invalid`	422	لا يُرجَع عند الشراء أبدًا
لا يمكن تعديل المستلم الآن	`direct_recharge_not_suspended`	409	لا يُرجَع عند الشراء أبدًا
المبلغ خارج الحدود	`amount_out_of_range`	422	لا يُرجَع عند الشراء أبدًا
منتج الشحن المباشر غير متاح	`direct_recharge_product_unavailable`	409	لا يُرجَع عند الشراء أبدًا
الباقة غير متاحة	`package_unavailable`	409	لا يُرجَع عند الشراء أبدًا
العداد مرفوض	`meter_rejected`	422	لا يُرجَع عند الشراء أبدًا
غير موجود	`resource_not_found`	404	هذا الاستدعاء لم يشترِ شيئًا
البطاقة غير موجودة	`card_not_found`	404	هذا الاستدعاء لم يشترِ شيئًا
المحفظة غير ممنوحة	`wallet_not_granted`	404	لم يشترِ شيئًا — ربما اشترت نسخة سابقة: استأنف بالمعرّف نفسه
فشل التحقق	`validation_failed`	422	هذا الاستدعاء لم يشترِ شيئًا
العملة غير مدعومة	`currency_not_supported`	422	هذا الاستدعاء لم يشترِ شيئًا

طلبات الشراء

ردود لا يتلقاها إلا طلب شراء.

الخطأ	الرمز	الحالة	إن كان طلب شراء
معرّف العملية مستخدم من قبل	`idempotency_conflict`	409	هذا الاستدعاء لم يشترِ شيئًا
طلب الشراء قيد المعالجة	`operation_processing`	202	قد يكتمل — استأنف بالمعرّف نفسه
يلزم الإذن باستخدام الدين المسموح	`allowed_debt_consent_required`	402	هذا الاستدعاء لم يشترِ شيئًا
الرصيد غير كافٍ	`insufficient_balance`	409	هذا الاستدعاء لم يشترِ شيئًا
الشراء غير مسموح	`purchase_not_allowed`	403	هذا الاستدعاء لم يشترِ شيئًا
رُفض طلب الشراء	`purchase_not_allowed`	409	هذا الاستدعاء لم يشترِ شيئًا
البطاقة غير متاحة	`card_unavailable`	409	هذا الاستدعاء لم يشترِ شيئًا
الكمية غير متاحة	`quantity_unavailable`	409	هذا الاستدعاء لم يشترِ شيئًا
تغيّر السعر	`price_changed`	409	هذا الاستدعاء لم يشترِ شيئًا

الحدود

بُلغ حدّ على عدد الاستدعاءات أو على الإنفاق.

الخطأ	الرمز	الحالة	إن كان طلب شراء
استُنفد حدّ الإنفاق	`owner_limit_exceeded`	409	هذا الاستدعاء لم يشترِ شيئًا
بُلغ الحدّ اليومي	`daily_limit_exceeded`	429	هذا الاستدعاء لم يشترِ شيئًا
تجاوزت حدّ الاستدعاءات	`rate_limited`	429	قد يكتمل — استأنف بالمعرّف نفسه
بُلغ سقف الإنفاق	`spending_limit_exceeded`	429	هذا الاستدعاء لم يشترِ شيئًا
بُلغ حدّ العناوين	`partner_network_limit_reached`	409	لا يُرجَع عند الشراء أبدًا

كشف البطاقات

تعذّر عرض رموز بطاقة.

الخطأ	الرمز	الحالة	إن كان طلب شراء
الكشف غير مسموح	`reveal_not_allowed`	409	لا يُرجَع عند الشراء أبدًا
الفاتورة أكبر من أن تُكشف	`invoice_reveal_limit_exceeded`	409	لا يُرجَع عند الشراء أبدًا

تسجيل مفتاح

رُفضت خطوة من خطوات تحويل الدعوة إلى مفتاح عامل.

الخطأ	الرمز	الحالة	إن كان طلب شراء
الدعوة غير صالحة	`invitation_invalid`	401	لا يُرجَع عند الشراء أبدًا
استُبدل التحدّي	`challenge_expired`	409	لا يُرجَع عند الشراء أبدًا
المفتاح العام غير صالح	`key_proof_invalid`	422	لا يُرجَع عند الشراء أبدًا
الدعوة مستخدمة من قبل	`key_duplicate`	409	لا يُرجَع عند الشراء أبدًا

لم يُتَّخذ قرار

تعذّر على أنيس إكمال الاستدعاء. وفي طلب الشراء تكون النتيجة غير معروفة.

الخطأ	الرمز	الحالة	إن كان طلب شراء
الخدمة غير متاحة	`dependency_unavailable`	503	قد يكتمل — استأنف بالمعرّف نفسه
انتهت مهلة الاستدعاء	`request_timeout`	504	قد يكتمل — استأنف بالمعرّف نفسه
خطأ داخلي	`internal_error`	500	قد يكتمل — استأنف بالمعرّف نفسه