Skip to main content

الطلب

تأخذ POST /v3/bills/discover ثلاثة حقول:

الاستجابة

يعني الرمز 200 أن الاكتشاف قُبل. الفواتير ليست ضمن هذه الاستجابة.

استطلاع الحالة حتى READY

استدعِ GET /v3/bills/transactions/{transactionId} كل 2 إلى 3 ثوانٍ إلى أن تخرج قيمة status من PENDING. ينتهي الاكتشاف عادةً خلال ثوانٍ؛ وقد يستغرق بضع دقائق عند ارتفاع الضغط.

الكائن bill

يدفع العميل amount + fee. تُضبط رسوم الخدمة لكل مُصدِر فاتورة وقد تتغيّر؛ اعرض دائمًا القيم الواردة في الاستجابة.

النتائج

قيمة error.code في اكتشاف بالحالة FAILED:

الأخطاء المتزامنة

تُعاد هذه الأخطاء فورًا، ولا تُنشأ أي معاملة.

حول ref

  • إلزامي، حتى 100 حرف.
  • يجب أن يكون فريدًا بين معاملاتك لدى ذلك الشريك. تؤدي إعادة استخدامه إلى 403 DUPLICATED_REF.
  • يُخزَّن في المعاملة ويُعاد بوصفه ref في كل استجابة.
  • يتيح لك الاستدراك بعد انتهاء مهلة الشبكة: تُخبرك GET /v3/bills/transactions/by-ref?ref=… ما إذا كان الاكتشاف قد أُنشئ.
أنشئ ref جديدًا لكل استدعاء.

التالي: دفع الفواتير

دفع فاتورة واحدة أو عدة فواتير في طلب واحد