نظرة عامة
يمكن لطريقة الدفع مع رمز مميّز أن تدعم حالة استخدام الرقم المرجعي. ينشئ مستخدم يريد الدفع مقابل السلع رقمًا مرجعيًا من خلال شركة تكامل الدفعات. يأخذ المستخدم بعد ذلك هذا الرقم المرجعي إلى متجر صغير، أو كشك، أو مصرف ويدفع الرقم المرجعي.
تتوافق طريقة الدفع النقدي أيضًا مع حالة استخدام الرقم المرجعي. يتمثّل الاختلاف الرئيسي بين طريقة الدفع مع رمز مميّز وطريقة الدفع النقدي في أنّ طريقة الدفع مع رمز مميّز تتطلّب الربط ويدعم طريقة ردّ الأموال، لأنّ طريقة الدفع النقدية لا تتطلّب الربط ولا تتيح عمليات ردّ الأموال. يوضّح هذا المستند آلية عمل الدمج في حالة استخدام الرقم المرجعي.
وعلى مستوى عالٍ، يتضمّن الدمج المسارَين التاليَين:
- مسار المصادقة
- مسار عملية الربط
- تدفق الشراء (مثل طريقة الدفع النقدية)
- خطوات ردّ الأموال
- تدفق الحوالة المالية
سيكون تدفق الشراء هو نفسه تدفق الشراء لطريقة الدفع النقدي.
مثال على عملية دمج باستخدام مصادقة إعادة توجيه الويب
واجهات برمجة التطبيقات ذات الصلة
مسار المصادقة
واجهة برمجة التطبيقات التي تم تنفيذها من قِبل جهة الدمج: مصادقة الويب
مسار عملية الربط
واجهة برمجة التطبيقات التي تنفّذها الشركة المتعهّدة: associateAccount على Payment Integrator host Integrator Affiliateized FOP API
مسار الشراء
واجهة برمجة التطبيقات التي تنفّذها وحدة الدمج: generateReferenceNumber وcancelReferenceNumber على Payment Integrator Plugins Tokenized FOP API
واجهة برمجة التطبيقات التي تنفّذها Google: referenceNumberPaidNotification على واجهة برمجة التطبيقات لإصدار الرموز المميّزة بنجمة في Google.
تدفق رد الأموال
واجهة برمجة التطبيقات التي تنفّذها شركة الدمج: ردّ الأموال من خلال Payment Integrator ضَاف Tokenized FOP API
تدفق الحوالات المالية
واجهة برمجة التطبيقات التي تنفّذها الشركة المتعهّدة: يُرجى الاطّلاع على Payment Integrator host Remittance API.
واجهة برمجة التطبيقات التي تنفّذها Google: يُرجى الاطّلاع على Google host Remittance API.
كيف تتلاءم جميع التدفقات معًا
إنشاء أداة
في واجهة المستخدم من Google، تتم إعادة توجيه المستخدم إلى صفحة ويب مستضافة على عملية الدمج لإجراء مصادقة الويب. بعد إجراء المصادقة بنجاح، يُعاد توجيه المستخدم إلى Google. وعندئذٍ ستتصل Google بـ associateAccount. سيكون requestId
في authenticationResponse
هو الطلب authenticationRequestId
الخاص بـ associateAccount. بعد إجراء عملية الربط بنجاح، تخزِّن Google البيانات الوصفية googlePaymentToken
(GPT) والبيانات الوصفية الأخرى كأداة للمستخدم.
إنشاء أداة - مسار المصادقة
إنشاء أداة - مسار الربط
إنشاء رقم مرجعي
عندما يريد المستخدم شراء سلع/خدمات باستخدام الأداة، تستدعي Google generateReferenceNumber باستخدام GPT. سيتم استخدام requestId
في عنوان الطلب generateReferenceNumber لتحديد معاملة واجهات برمجة التطبيقات ذات الصلة.
الرقم المرجعي للدفع
بعد أن يدفع المستخدم الرقم المرجعي بلا اتصال بالإنترنت، ستتصل الشركة المختصة بالتكامل بـ referenceNumberPaidNotification. سيكون العنصر requestId
ضمن عنوان الطلب generateReferenceNumber هو generateReferenceNumberRequestId
للطلب referenceNumberPaidNotification.
إلغاء معاملة
وإذا قرّر المستخدم إلغاء المعاملة قبل الدفع، ستتصل Google بالرقم cancelReferenceNumber. سيكون requestId
ضمن عنوان الطلب generateReferenceNumber generateReferenceNumberRequestId
من طلب cancelReferenceNumber.
ردّ أموال معاملة
إذا أراد المستخدم استرداد المبلغ الذي دفعته بعد دفع المبلغ المرجعي، ستتصل Google بفريق ردّ الأموال. ستمثل requestId
ضمن عنوان الطلب generateReferenceNumber القيمة transactionId
لطلب ردّ الأموال.
الحوالة المالية
واستنادًا إلى العقد، ستطلب Google من Google إرسال remittanceStatementNotification لإرسال إشعار إلى جهة الدمج عندما يصبح كشف الحساب جاهزًا. بعد ذلك، ستتواصل الشركة المتعهّدة مع Google host Remittance API لإجراء التسوية.