الحصول على معاملة بالمرجع
دفع الفواتير
الحصول على معاملة بالمرجع
ابحث عن معاملة باستخدام المرجع الذي قدّمته
GET
الحصول على معاملة بالمرجع
نظرة عامة
يعثر على معاملة عبرref الذي أرسلته عند بدء الاستكشاف. ويُرجع الكائن نفسه تمامًا الذي يُرجعه الحصول على معاملة بالمعرّف.هذا هو مسار الاسترداد. عندما تضيع استجابة بسبب انتهاء مهلة أو تعطّل أو إعادة نشر، ابحث عن ref — ولا تُعِد إرسال عملية الكتابة أبدًا.يكون
ref فريدًا لكل شريك، لا على مستوى النظام كله. إذا أعدت استخدام سلسلة ref نفسها لشريكين مختلفين، فمرّر partner أيضًا حتى يكون البحث غير ملتبس.معلمات الاستعلام
string
مطلوب
المرجع الذي قدّمته عند إنشاء الاستكشاف. 100 حرف كحد أقصى.
string
اختياري. أحد القيم
ADE أو SONELGAZ أو SEAAL أو AADL أو Algérie Télécom. يحصر البحث في ذلك المُصدِر.الاستجابة
مطابقة لـ الحصول على معاملة بالمعرّف — كائن المعاملة الكامل، مغلَّفًا في الغلاف القياسي. راجع تلك الصفحة للاطلاع على مرجع الحقول حقلًا بحقل، وعلى الحقول التي تظهر في كل حالة.boolean
مطلوب
true عند العثور على معاملة.object
مطلوب
كائن المعاملة. مرجع الحقول الكامل →
object
مطلوب
string
مطلوب
معرّف الربط، يُرسَل أيضًا في ترويسة الاستجابة
X-Request-Id.الأمثلة
استجابة النجاح
استجابات الخطأ
400 — خطأ في التحقق
400 — خطأ في التحقق
كان ما العمل: أرسل
ref مفقودًا أو أطول من اللازم، أو لم تكن partner قيمة معروفة.ref كمعلمة استعلام، مُرمَّزة لعناوين URL، وبطول 100 حرف كحد أقصى.401 — رمز وصول مفقود أو غير صالح
401 — رمز وصول مفقود أو غير صالح
404 — لم يُعثر على المعاملة
404 — لم يُعثر على المعاملة
لا توجد معاملة بذلك ما العمل: بعد فشل عملية كتابة، يكون
ref تخصّ حسابك في هذه البيئة.404 هنا هو الدليل على أن الطلب لم يصل أبدًا — ومن الآمن إرساله مرة أخرى بـ ref نفسه. وتحقّق أيضًا من أنك تستخدم مفتاح البيئة التي أُنشئت فيها المعاملة.503 — المصادقة أو الخدمة غير متاحة
503 — المصادقة أو الخدمة غير متاحة
لم نتمكن من التحقق من مفتاحك في الوقت المناسب، أو أن الواجهة في صيانة مُخطّط لها.ما العمل: التزم بترويسة
Retry-After (5 ثوانٍ) وأعد المحاولة. تكرار البحث آمن دائمًا.الاسترداد من استجابة ضائعة
النمط نفسه للاستكشاف وللدفع: إذا فشلت عملية الكتابة بطريقة لا تستطيع تفسيرها، فاسأل عمّا يشير إليهref قبل أن ترسل أي شيء مرة أخرى.أفضل الممارسات
ابحث، لا تُعِد الإرسال
كل انتهاء مهلة وكل
DUPLICATED_REF تُجاب هنا، لا بعملية كتابة ثانية.مرّر الشريك
لا يكلّف شيئًا ويزيل أي التباس عندما توجد سلسلة
ref نفسها لدى مُصدِرَي فواتير.خزّن المرجع مع طلبك
ref لا تستطيع إعادة بنائه هو معاملة لا تستطيع استردادها.استعلم بالمعرّف بمجرد حصولك عليه
استخدم هذا endpoint للاسترداد، ثم استعلم بـ
transactionId — معلمة أقل يمكن أن تخطئ فيها.Endpoints ذات الصلة
الحصول على معاملة بالمعرّف
كائن المعاملة الكامل
قائمة المعاملات
صفِّ السجل واستعرضه بالصفحات
استكشاف الفواتير
حيث يُنشأ
refاستقصاء الحالة
مُستقصٍ بمستوى الإنتاج

