الموثوقية والأخطاء

منع التكرار

استجابات الأخطاء

تستخدم جميع الأخطاء application/problem+json. تعامل مع code وخزّن request_id واعرض رسالة آمنة للتاجر دون كشف تفاصيل المزود.

{
  "type": "https://www.lahjty.com/problems/rate-limit-exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "rate_limit_exceeded",
  "detail": "Too many requests. Retry after the indicated delay.",
  "request_id": "req_01jexample"
}

سياسة الرجوع وإعادة المحاولة

1. استخدم مهلة تناسب نقطة النهاية؛ قد تستغرق الوسائط وقتاً أطول من النص.
2. بعد انتهاء مهلة غير حاسم، أعد الطلب نفسه تماماً مع مفتاح idempotency نفسه.
3. احترم Retry-After عند 429 وأخطاء المزود المؤقتة.
4. لا توقف إرسال الحملة بسبب Lahjty. احتفظ بنص التاجر العادي كخيار رجوع.

الاسترداد

تُسترد تكلفة فشل المزود أو التوليد تلقائياً وفق عقد النقطة. ينتقل رفض واتساب غير المعدّل الذي يبلغه الشريك إلى PENDING_VERIFICATION من دون تغيير الرصيد. تطبق Lahjty استرداد العملتين مرة واحدة فقط بعد التحقق من دليل موثوق من Meta أو المزود. تُسجّل الإرسالات المعدلة لكنها لا تصبح مرشحة للاسترداد.