Google Standard Payments: طريقة دفع البطاقة (FOP)

نظرة عامة

تتيح واجهة برمجة التطبيقات Card FOP (طريقة الدفع) عمليات الدفع التي يتم إجراؤها باستخدام البطاقات العادية. يمكن أن تشمل هذه البطاقات بطاقات الائتمان أو بطاقات السحب الآلي. يوجد كل من ورقة يتم توفير تدفق رسائل مزدوجة للدفعات.

المفاهيم المهمة

رموز واصطلاحات

يجب تفسير الكلمات الأساسية "MUST" و"MUST NOT" و"REQUIRED" و"SHALL" و"SHALL NOT" و"SHOULD" و"SHOULD NOT" و"RECOMMENDED" و"MAY" و "OPTIONAL" في هذه المستندات على النحو الموضح في RFC 2119.

الطوابع الزمنية

يتم تمثيل جميع الطوابع الزمنية بالمللي ثانية منذ حقبة Unix بالتوقيت العالمي المنسق.

مثال:

  • 14 آب (أغسطس) 2010، 16:30:00.00 صباحًا بتوقيت غرينتش = 1281803400000
  • 6 تشرين الثاني (نوفمبر) 2007، 9:37:00 مساءً بتوقيت المنطقة الزمنية الشرقية = 1194410220000

المبالغ

يتم تمثيل القيم النقدية في واجهة برمجة التطبيقات هذه باستخدام تنسيق يُسمّى "micros"، وهو معيار في Google. وحدات المايكرو هي تنسيق دقة ثابتة يستند إلى عدد صحيح. لتمثيل القيمة النقدية بالميكرو، اضرب قيمة العملة القياسية في 1,000,000.

مثال:

  • 1.23 دولار أمريكي = 1230000 دولار أمريكي صغير
  • 0.01 دولار أمريكي = 10000 دولار أمريكي (أو ما يعادله بالعملة المحلية)

العجزية

يجب أن يكون لجميع استدعاءات الطرق ضمن واجهة برمجة التطبيقات هذه سلوكًا ثابتًا. ببساطة، يجب ألا تحاول عمليات الدمج إعادة معالجة أي طلب تمت معالجته بنجاح، بل يجب الإبلاغ عن الاستجابة الخاصة بالمعالجة الناجحة. تحتوي جميع الطرق على عنوان RequestHeader شائع يحتوي على requestId. إن رقم تعريف الطلب هذا هو مفتاح حالة الهوية لجميع المكالمات.

بالنسبة إلى أي إجابة غير طرفية (غير HTTP 200)، يجب ألا تتم معالجتها بشكل مجهول. لذا فإن الطلب الذي حصل سابقًا على 400، عند استدعائه مرة ثانية، يجب ألا يعرض بشكل واضح 400، بل يجب إعادة تقييمه. عند إعادة التقييم، يمكن أن تعرض 400 أو تتم معالجتها بنجاح.

لمزيد من المعلومات حول الهوية، اطّلِع على هذا الدليل التفصيلي.

حجز تدفق الالتقاط

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

تنفيذ وحدة تكامل الدفع

تنفّذ Google

لمزيد من المعلومات حول الحصول على الحجز، يُرجى الاطّلاع على الدليل المفصّل.

تدفق تحويل الأموال

يتألّف تدفق تحويل الأموال من رسالة واحدة في الأموال التي يتم الحصول عليها بشكل مباشر. يتكون التدفق من طريقة واحدة الجهة المسؤولة عن دمج عمليات الدفع المُسمّاة "Capture" هذه الطريقة يتحقق متزامنًا من وجود الأموال المتاحة ويلتقط الأموال إذا نجحت.

تنفيذ وحدة تكامل الدفع

تنفّذ Google

لمزيد من المعلومات عن تحويل الأموال، راجع الدليل المفصّل.

مسار ردّ الأموال

يتم استخدام مسار ردّ الأموال لإرجاع الأموال التي كانت في السابق من خلال تدفق الالتقاط الاحتياطي أو تدفق تحويل الأموال:

تنفيذ وحدة تكامل الدفع

تنفّذ Google

لمزيد من المعلومات حول عمليات ردّ الأموال، يمكنك الاطّلاع على هذا الدليل التفصيلي.

مسار الاعتراض

مسار الاعتراض: تُستخدم لإبلاغ Google بالنزاعات عمليات ردّ المبالغ المدفوعة التي يطلب فيها العميل الحصول على تعويض. ليست كل مكالمة إلى حركة الأموال، ولكن يمكن استخدام هذا التدفق لإرجاع الأموال إلى العميل، أو العكس وإعادتها إلى Google. يمكن استخدام هذا التدفق في إضافةً إلى خطوات الإبلاغ عن الاحتيال، ولكنّها لا تسمح الاحتيال بالضرورة.

تنفّذ Google

لمزيد من المعلومات حول النزاعات، يمكنك الاطّلاع على هذا الدليل التفصيلي.

مسار الإبلاغ عن الاحتيال

تهدف خطوات الإبلاغ عن الاحتيال إلى إبلاغ Google عملية احتيال محتملة. لا تشير هذه المعلومات ضمنًا إلى أي حركة للأموال تُستخدم فقط لإبلاغ محرك المخاطر في Google بالحدث حتى تتعرض عملية الاحتيال المخاطر. وقد يكون ذلك مصحوبًا بنزاع أو رد مبالغ مدفوعة من خلال مسار الاعتراض:

تنفّذ Google

لمزيد من المعلومات حول الإبلاغ عن الاحتيال، يُرجى الاطّلاع على الدليل المفصّل.