Billing Service Unavailable

billing-service-unavailable · 503

لم تستطع الـ API الوصول إلى خدمة الفوترة، أو لم يكن لديها سعر صرف تحتاجه، فلم تغير شيئا.

كل الصفحات

عندما لا تصل الـ API إلى الفوترة، يبين النص الذي بين القوسين في آخر detail ما فشل. والفوترة تسأل مباشرة عندما تتغير الخطة، وأول مرة يقرأ فيها وضع فوترة المنظمة. وإذا نقص سعر صرف، يسمي الـ detail العملة.

لا يضيف هذا النوع شيئا إلى الحقول التي في كل خطأ.

الأسباب الشائعة

  • كانت خدمة الفوترة متوقفة أو بطيئة أو أعادت خطأ في تلك اللحظة.
  • ربط هذه النسخة بالفوترة غير مضبوط، والنص الذي بين القوسين يقول ذلك.
  • لم يكن لدى الفوترة سعر صرف للعملة في تلك اللحظة، أو أصدرت الفاتورة المقروءة دون سعر صرف.

كيف تصلح الطلب

  • أعد المحاولة بعد قليل: لم يتغير شيء، فإرسال النداء نفسه مرة أخرى آمن.
  • وإذا استمر الفشل، فأخبر المستخدم واذكر detail.
  • وإذا قال الـ detail إن الفاتورة أصدرت دون سعر صرف، فلا تعد المحاولة: الجواب لن يتغير، فأخبر المستخدم واذكر detail.

مثال على الرد

json
{
  "type": "billing-service-unavailable",
  "title": "Billing Service Unavailable",
  "detail": "The billing service could not be reached, so this account's billing state is unknown. Nothing has changed; try again shortly. (billing answered 502)",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/billing/account/plan",
  "method": "PUT",
  "instance": "PUT /v1/billing/account/plan",
  "status": 503,
  "docs": "https://ghaym.me/docs/errors/billing-service-unavailable"
}