Google Standard Payments: کارت FOP

بررسی اجمالی

کارت FOP (فرم پرداخت) API از پرداخت هایی که با استفاده از کارت های استاندارد انجام می شود پشتیبانی می کند. اینها می توانند کارت های اعتباری و بدهی باشند. برای پرداخت ها جریان تک پیامکی و دوگانه وجود دارد.

مفاهیم مهم

نمادها و قراردادها

کلمات کلیدی "باید"، "نباید"، "الزامی"، "باید"، "نباید"، "باید"، "نباید"، "توصیه شده"، "ممکن است" و "اختیاری" در این اسناد هستند. همانطور که در RFC 2119 شرح داده شده است تفسیر شود.

مهر زمانی

تمام مهرهای زمانی به عنوان میلی ثانیه از زمان یونیکس در UTC نشان داده می شوند.

مثلا:

  • 14 آگوست 2010، 16:30:00.00 صبح به وقت گرینویچ = 1281803400000
  • 6 نوامبر 2007 9:37:00 بعد از ظهر MST = 1194410220000

مبالغ

مقادیر پولی در این API با استفاده از قالبی به نام "micro" که یک استاندارد در Google است، نشان داده می شود. میکرو یک قالب دقیق و ثابت مبتنی بر عدد صحیح است. برای نمایش یک ارزش پولی در میکرو، ارزش ارز استاندارد را در 1,000,000 ضرب کنید.

مثلا:

  • USD $1.23 = 1230000 میکرو USD
  • USD $0.01 = 10000 میکرو USD

ناتوانی

همه فراخوانی‌های متد در این API باید رفتار ناتوانی داشته باشند. به بیان ساده، یکپارچه‌سازها نباید تلاش کنند تا درخواست‌هایی را که قبلاً با موفقیت پردازش شده است، دوباره پردازش کنند؛ در عوض، پاسخ پردازش موفقیت‌آمیز باید گزارش شود. همه متدها یک RequestHeader مشترک دارند که حاوی یک requestId است. این requestId کلید ناتوانی برای همه تماس‌ها است.

برای هر پاسخ غیر پایانه ای (غیر HTTP 200)، نباید به صورت بی اختیار پردازش شود. بنابراین درخواستی که قبلاً 400 دریافت کرده بود، وقتی برای بار دوم فراخوانی شد، نباید به طور غیرقابل قبولی 400 را برگرداند، باید مجدداً ارزیابی شود. در ارزیابی مجدد، می تواند 400 را برگرداند یا با موفقیت پردازش شود.

برای اطلاعات بیشتر در مورد ناتوانی جنسی، این راهنمای دقیق را ببینید.

جریان ضبط رزرو

جریان جمع آوری ذخیره یک جریان دو پیامی است که در آن وجوه ابتدا ذخیره شده و سپس جذب می شود. در طول رزرو هیچ جابجایی پولی رخ نمی دهد. پس از آن می توان رزرو را لغو یا ضبط کرد. نتیجه نهایی ضبط یا لغو به صورت ناهمزمان از طریق یک اعلان به Google بازگردانده می شود.

Payment Integrator پیاده سازی می کند

گوگل پیاده سازی می کند

برای اطلاعات بیشتر در مورد ذخیره ذخیره، این راهنمای دقیق را ببینید.

جریان انتقال وجه

جریان انتقال وجه یک جریان پیام واحد است که وجوه مستقیماً در آن جمع آوری می شود. این جریان از یک روش واحد تشکیل شده است که توسط Payment Integrator به نام Capture پیاده سازی شده است. این روش به طور همزمان وجوه موجود را بررسی می کند و در صورت موفقیت آمیز بودن وجوه را جمع آوری می کند.

Payment Integrator پیاده سازی می کند

گوگل پیاده سازی می کند

برای اطلاعات بیشتر در مورد انتقال وجه، این راهنمای دقیق را ببینید.

جریان بازپرداخت

جریان بازپرداخت برای بازگرداندن وجوهی استفاده می‌شود که قبلاً از طریق جریان ذخیره ذخیره یا جریان انتقال وجوه جمع‌آوری شده‌اند.

Payment Integrator پیاده سازی می کند

گوگل پیاده سازی می کند

برای اطلاعات بیشتر در مورد بازپرداخت این راهنمای دقیق را ببینید.

جریان اختلاف

جریان اختلاف برای اطلاع رسانی به Google در مورد اختلافات و بازپرداخت هزینه که در آن مشتری درخواست بازپرداخت می کند، استفاده می شود. هر تماسی به معنای جابه‌جایی پول نیست، اما این جریان می‌تواند برای بازگرداندن وجوه به مشتری یا معکوس کردن آن و برگرداندن آن به Google استفاده شود. این جریان می تواند علاوه بر جریان گزارش تقلب مورد استفاده قرار گیرد اما لزوماً شامل تقلب نمی شود.

گوگل پیاده سازی می کند

برای اطلاعات بیشتر در مورد اختلافات، این راهنمای دقیق را ببینید.

جریان گزارش تقلب

جریان گزارش کلاهبرداری برای اطلاع رسانی به گوگل از کلاهبرداری احتمالی است. این اطلاعات دلالت بر هیچ جابجایی پولی ندارد و صرفاً برای اطلاع‌رسانی موتور ریسک Google از رویداد استفاده می‌شود تا کلاهبرداری کلی کاهش یابد. این می تواند با اختلاف یا استرداد هزینه از طریق جریان اختلاف همراه باشد.

گوگل پیاده سازی می کند

برای اطلاعات بیشتر در مورد گزارش تقلب، این راهنمای دقیق را ببینید.