رموز الأخطاء

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

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

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

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

الخطأ	الرمز	الحالة	إن كان طلب شراء
بيانات اعتماد غير صالحة	`invalid_credentials`	401	هذا الاستدعاء لم يشترِ شيئًا
انتهت صلاحية التوقيع	`signature_expired`	401	هذا الاستدعاء لم يشترِ شيئًا
بصمة محتوى غير صالحة	`invalid_content_digest`	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	هذا الاستدعاء لم يشترِ شيئًا

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

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

الخطأ	الرمز	الحالة	إن كان طلب شراء
غير موجود	`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	هذا الاستدعاء لم يشترِ شيئًا

كشف البطاقات

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

الخطأ	الرمز	الحالة	إن كان طلب شراء
الكشف غير مسموح	`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	قد يكتمل — استأنف بالمعرّف نفسه