توثيق واجهة برمجة التطبيقات لإشعارات الاستدعاء (Callback) في Gate Pay: https://docs.gate.com/api-reference/version/100/en/common/asyncNotification
تفسير معلومات حالة إشعار الاستدعاء للدفع
نوع العنوان الديناميكي
1. إشعار وصول أموال الدفع إلى العنوان الديناميكي (biztype = TRANSFER_ADDRESS)
TRANSFERRED_ADDRESS_IN_TERM: يتم إضافة الأموال فورًا خلال فترة صلاحية الطلب.
TRANSFERRED_ADDRESS_DELAY: إذا تم الدفع بعد انتهاء فترة الصلاحية، سيتم إضافة المبلغ المدفوع فعليًا إلى حساب رصيد التاجر (إضافة فورية بعد فترة الصلاحية).
2. إشعار تغيير حالة طلب الدفع إلى العنوان الديناميكي (biztype = PAY_ADDRESS)
PAY_SUCCESS: تم الدفع بنجاح.
PAY_CLOSE: انتهت صلاحية الطلب.
PAY_EXPIRED_IN_PROCESS: في انتظار تأكيد الأموال على السلسلة.
نوع العنوان الثابت
1. نجاح الدفع إلى العنوان الثابت (biztype=PAY_FIXED_ADDRESS)
PAY_SUCCESS: تم الدفع بنجاح وتمت إضافة الأموال.
2. تصنيف العنوان الثابت كعنوان محفوف بالمخاطر (biztype=FIXED_ADDRESS_RISK)
RISK_ADDRESS: تم تصنيف العنوان الثابت كعنوان محفوف بالمخاطر.
نوع الدفع إلى عنوان غير طبيعي
بالنسبة لكل معاملة دفع غير طبيعية، سترسل Gate Pay إشعار webhook إلى التاجر المعني.
قيمة bizType لهذا النوع من الدفع هي دائمًا PAY_UNRESOLVED.
يجب على التجار تحديد سبب المشكلة بناءً على قيمة errorType في البيانات، والرجوع إلى دليل معالجة الدفعات غير الطبيعية في Gate Pay أو التواصل مع مدير حساب Gate Pay الخاص بهم.
- address_risk_address
— عنوان ديناميكي عالي المخاطر - address_error_currency
— عملة غير صحيحة للعنوان الديناميكي - address_error_chain
— شبكة بلوكتشين غير صحيحة للعنوان الديناميكي - fix_error_currency
— عملة غير صحيحة للعنوان الثابت - fix_error_chain
— شبكة بلوكتشين غير صحيحة للعنوان الثابت - fix_risk_address
— عنوان ثابت عالي المخاطر - fix_delete
— تم حذف العنوان الثابت - fix_partial_delete
— تم حذف جزء من العنوان الثابت
حول معلومات إشعار الاستدعاء لمدفوعات العناوين الديناميكية
لماذا يوجد نوعان من معلومات إشعار الاستدعاء للدفع؟
- إشعار وصول الأموال (TRANSFER_ADDRESS): إشعار بالمبلغ الفعلي الذي تم إضافته.
- إشعار تغيير حالة الطلب (PAY_ADDRESS): إشعار بتغير حالة الطلب.
يحتاج التجار إلى استخدام كلا النوعين من المعلومات لتحديد ما إذا كان الطلب ناجحًا، حتى يتمكنوا من متابعة التسليم أو معالجة الطلبات الفاشلة.
متى يتم إرسال إشعارات الاستدعاء؟
- إشعار وصول الأموال: بعد تأكيد الدفع على السلسلة، تتم إضافة الأموال إلى حساب التاجر في الوقت الفعلي، ويتم إرسال إشعار استدعاء للتاجر.
- إشعار تغيير حالة الطلب: يتم إرساله عند تغير حالة الطلب.
سيناريوهات الدفع بالعنوان الديناميكي وتحديد حالة الطلب
1. دفع كامل أو زائد مرة واحدة خلال فترة الصلاحية
الوصف: طالما قام المستخدم بدفع المبلغ الكامل أو أكثر خلال فترة صلاحية الطلب، يتم إرسال إشعار استدعاء في الوقت الفعلي بعد تأكيد الدفع على السلسلة.
حالة الطلب: في البداية، ينتظر النظام تأكيد الأموال على السلسلة ويرسل إشعار استدعاء بحالة وسيطة: bizStatus هو PAY_EXPIRED_IN_PROCESS. بعد التأكيد على السلسلة، يصبح الطلب ناجحًا، ويتم إرسال إشعار استدعاء بحالة bizStatus PAY_SUCCESS وقيمة المبلغ المضاف doneAmountOnChain.
إشعار وصول الأموال: bizStatus هو TRANSFERRED_ADDRESS_IN_TERM، والمبلغ المضاف هو transferAmount.
2. دفع أقل من المبلغ المطلوب خلال فترة الصلاحية
الوصف: إذا دفع المستخدم مبلغًا أقل من قيمة الطلب خلال فترة الصلاحية، بعد التأكيد على السلسلة، يتم إضافة المبلغ المدفوع فعليًا إلى التاجر، ويتم إرسال إشعار وصول الأموال في الوقت الفعلي.
حالة الطلب: خلال فترة الصلاحية، لا تتغير حالة الطلب، ولا يتم إرسال إشعار استدعاء بحالة الطلب.
إشعار وصول الأموال: bizStatus هو TRANSFERRED_ADDRESS_IN_TERM، والمبلغ المضاف هو transferAmount.
3. دفع أقل من المبلغ المطلوب خلال فترة الصلاحية دون إكمال الفرق
الوصف: إذا دفع المستخدم مبلغًا أقل من قيمة الطلب خلال فترة الصلاحية ولم يكمل الفرق خلال نفس الفترة.
حالة الطلب: عند انتهاء فترة صلاحية الطلب، يتم إرسال إشعار استدعاء بحالة الطلب. bizStatus هو PAY_CLOSE، والمبلغ المضاف هو doneAmountOnChain.
إشعار وصول الأموال: تم إرسال إشعار وصول الأموال بعد الدفع، ولن يتم إرساله مرة أخرى.
4. دفع أقل من المبلغ المطلوب خلال فترة الصلاحية ثم إكمال الفرق لاحقًا
4.1 إكمال الدفع خلال فترة الصلاحية:
بعد أن يكمل المستخدم المبلغ المتبقي:
حالة الطلب: ينتظر النظام تأكيد الأموال على السلسلة ويرسل إشعار استدعاء بحالة وسيطة: bizStatus هو PAY_EXPIRED_IN_PROCESS.
إشعار وصول الأموال: لا يتم إرسال إشعار وصول الأموال أثناء انتظار تأكيد الدفع الإضافي على السلسلة.
بعد التأكيد على السلسلة:
حالة الطلب: بمجرد تأكيد الأموال على السلسلة وكان المجموع كافيًا، يعتبر الطلب ناجحًا. bizStatus هو PAY_SUCCESS والمبلغ المضاف هو doneAmountOnChain (إجمالي جميع الدفعات).
إشعار وصول الأموال: bizStatus هو TRANSFERRED_ADDRESS_IN_TERM، والمبلغ المضاف هو transferAmount.
4.2 إكمال الدفع بعد انتهاء فترة الصلاحية:
حالة الطلب: بما أن المبلغ الكامل لم يُدفع خلال فترة الصلاحية، يتم إرسال إشعار استدعاء بحالة الطلب عند انتهاء الفترة. bizStatus هو PAY_CLOSE، والمبلغ المضاف هو doneAmountOnChain.
إشعار وصول الأموال: تم إرسال إشعار وصول الأموال بعد الدفع، ولن يتم إرساله مرة أخرى.
إذا أكمل المستخدم المبلغ المتبقي بعد فترة الصلاحية: يتم إرسال إشعار وصول الأموال مع bizStatus كـ TRANSFERRED_ADDRESS_DELAY، والمبلغ المضاف هو transferAmount. (في هذه الحالة، لا يتم إرسال إشعار استدعاء إضافي بحالة الطلب، ولا يتضمن الإشعار النهائي حقل doneAmountOnChain. إذا أكمل المستخدم الدفع عبر عدة معاملات، يجب على التاجر جمع جميع قيم transferAmount من الإشعارات لتأكيد إجمالي المبلغ المضاف.)
5. الدفع بعد انتهاء الصلاحية
الوصف: إذا دفع المستخدم بعد انتهاء فترة صلاحية الطلب، سواء كان دفعًا جزئيًا أو كليًا أو زائدًا، تتم إضافة الأموال في الوقت الفعلي بعد تأكيد الدفع على السلسلة.
تغير حالة الطلب: بما أنه لم يتم الدفع خلال فترة الصلاحية، يتم إرسال إشعار استدعاء بحالة bizStatus PAY_CLOSE عند انتهاء الفترة.
وصول الأموال: لا يوجد إشعار وصول أموال.
الدفع بعد انتهاء الصلاحية: بعد انتهاء الصلاحية، مع كل دفعة يتم إرسال إشعار وصول أموال بحالة bizStatus كـ TRANSFERRED_ADDRESS_DELAY، والمبلغ المضاف هو transferAmount. (في هذه الحالة، لا يتم إرسال إشعار استدعاء إضافي بحالة الطلب، ولا يتضمن الإشعار النهائي حقل doneAmountOnChain. إذا أكمل المستخدم الدفع عبر عدة معاملات، يجب على التاجر جمع جميع قيم transferAmount من الإشعارات لتأكيد إجمالي المبلغ المضاف.)
يجب على التجار استخدام كل من إشعارات حالة الطلب وإشعارات وصول الأموال لتحديد ما إذا كان الطلب ناجحًا.
6. معلومات إشعار الاستدعاء للطلبات غير الطبيعية عند الدفع بالعنوان الديناميكي
6.1 الدفع بعملة أو شبكة بلوكتشين مختلفة عن الطلب
سيتلقى التاجر إشعار استدعاء مع Biztype=PAY_UNRESOLVED وdata.errorType=address_error_currency أو address_error_chain.
6.2 الأموال المصنفة كمحفوفة بالمخاطر وتم اعتراضها
سيتلقى التاجر إشعار استدعاء مع biztype=PAY_UNRESOLVED وdata.errorType=address_risk_address.
حول معلومات إشعار الاستدعاء للعناوين الثابتة
1. نجاح الدفع وإضافة الرصيد
سيتم استلام إشعار PAY_SUCCESS، مما يدل على نجاح الدفع وإضافة الأموال.
2. إشعار الدفع غير الطبيعي
2.1 الدفع بعملة/شبكة مختلفة عن الطلب
سيتلقى التاجر إشعار استدعاء مع biztype=PAY_UNRESOLVED وdata.errorType=fix_error_currency أو fix_error_chain.
2.2 أموال محفوفة بالمخاطر
سيتلقى التاجر إشعار استدعاء مع biztype=PAY_UNRESOLVED وdata.errorType=fix_risk_address.
2.3 الدفع إلى عنوان ثابت تم حذفه
سيتلقى التاجر إشعار استدعاء مع biztype=PAY_UNRESOLVED وdata.errorType=fix_delete أو fix_partial_delete.
3. إشعار خطر العنوان الثابت
سيتم استلام إشعار مع bizType=FIXED_ADDRESS_RISK وbizStatus=RISK_ADDRESS، مما يشير إلى أن عنوان الاستلام الثابت المرتبط بالتاجر تم تحديده كعنوان محفوف بالمخاطر. يجب على التجار حذف العنوان الثابت المعني فورًا. إذا استمر المستخدمون في الدفع إلى هذا العنوان، فلن تتم إضافة الأموال.
إخلاء مسؤولية
المحتوى الوارد هنا مُقدَّم لأغراض مرجعية وتعليمية فقط، ولا يشكّل أي نصيحة مالية أو استثمارية أو تداولية أو قانونية، كما لا يُعد عرضًا أو دعوة لشراء أو بيع أي أصول رقمية. لا تقدّم Gate أي تعهدات أو ضمانات صريحة أو ضمنية بشأن دقة المعلومات الواردة هنا أو اكتمالها أو توقيتها. قد يتم تحديث أو تعديل ميزات المنتجات والواجهات والقواعد وهياكل الرسوم في أي وقت. يرجى الرجوع إلى أحدث الإعلانات والمعلومات الفعلية المعروضة على منصة Gate للحصول على أدق التفاصيل.
تنطوي الاستثمارات في الأصول الرقمية على مخاطر كبيرة، وقد تتقلب الأسعار بشكل ملحوظ. وقد تفقد كامل مبلغ استثمارك. يرجى اتخاذ قراراتك بحذر بناءً على وضعك المالي وقدرتك على تحمّل المخاطر بعد الفهم الكامل للمخاطر المرتبطة بذلك. وإذا لزم الأمر، يُنصح باستشارة مستشار مالي أو قانوني مستقل.
لمزيد من المعلومات حول المخاطر المحتملة، يرجى الرجوع إلى إفصاح المخاطر واتفاقية المستخدم الخاصة بـGate.
