مقدمه‌ای بر پرداخت‌های استاندارد Google برای شرکت‌های مخابراتی

در دنیای پرداخت‌های استاندارد Google، صورت‌حساب شرکت مخابراتی به‌عنوان یک فرم پرداخت توکن‌شده (FOP) در نظر گرفته می‌شود، به این معنی که Google و Payment Integrator برای ایجاد یک رمز، یک بار اعتبار هویت حساب را مبادله می‌کنند. بعداً، این توکن به Payment Integrator ارائه می‌شود تا حساب مورد نظر را شناسایی کند.

سایر اشکال پرداخت نیز از توکن‌سازی استفاده می‌کنند، بنابراین ما یک مرور کلی از FOPهای توکن‌شده داریم که همگی بیشتر به صورت‌حساب شرکت مخابراتی مرتبط هستند. جریان احراز هویت ، ارتباط ، خرید و حواله همه با جزئیات بیشتری در آن نمای کلی توضیح داده شده است. این صفحه جزئیات بیشتری را در زمینه صورت‌حساب شرکت مخابراتی ارائه می‌کند.

شرکت‌های مخابراتی با پیاده‌سازی APIهایی که جریان‌های زیر را تشکیل می‌دهند، به Google Standard Payments وارد می‌شوند:

جریان شرح معادل مشخصات DCB3
احراز هویت حساب کاربر را در سیستم Payment Integrator شناسایی و احراز هویت می کند که برای انجام پرداخت های DCB استفاده می شود. SMS-MO با GoogleUserToken
اتحادیه یک توکن با عمر طولانی را مبادله می کند که Google و Payment Integrator توافق کرده اند که می تواند برای پرداخت با استفاده از حساب Payment Integrator کاربر استفاده شود. پاسخ تماس تاییدکننده با OperatorUserToken و GetProvisioning()
انتقال سرمایه به طور همزمان وجوه را از حساب Payment Integrator کاربر خارج می کند. بدهی را به Payment Integrator منتقل می کند خطوط Auth() و CHARGE در فایل های درخواست دسته ای
بازپرداخت به طور همزمان برخی یا همه وجوه مربوط به FundsTransfer قبلی را به حساب Payment Integrator کاربر برمی‌گرداند. مسئولیت را به Google منتقل می کند خطوط بازپرداخت در فایل های درخواست دسته ای
حواله تسویه حساب مبتنی بر API، ترجیحا به صورت روزانه PDF فاکتور ماهانه، فایل جزئیات فاکتور ماهانه، فایل recon روزانه
UpdateAssociatedAccount Google را از تغییرات حساب Payment Integrator کاربر (مثلاً محدودیت‌های تراکنش یا وضعیت تأمین) مطلع می‌کند. نظرسنجی GetProvisioning().
تقلب به Google درباره تراکنش‌هایی که به دلیل اختلاف کاربر معکوس شده‌اند، اطلاع می‌دهد. این برای بهبود موتور ریسک Google استفاده می‌شود، اما بر تعهدات پولی تأثیری ندارد هیچ یک

مقایسه کلی با مشخصات DCB3

مشخصات Google Standard Payments همان مشکلاتی را حل می کند که DCB3 Spec حل می کند. با این حال، از فناوری‌های مختلف و طراحی‌های API استفاده می‌کند که راه‌حل را بهبود می‌بخشد. در اینجا تفاوت های عمده در یک نگاه وجود دارد:

مقایسه فناوری پشته

تمام ارتباطات API با استفاده از HTTPS POST با JSON رمزگذاری شده و امضا شده با PGP انجام می شود. این بدان معناست که Google و Payment Integrator هر کدام فقط یک کلید PGP برای چرخش دارند. این فناوری ها نیز پشتیبانی بهتری نسبت به SOAP دارند. جزئیات بیشتر در مورد پشته ارتباطی را می توانید در اینجا بیابید .

مقایسه فلسفه API

DCB3 برای تطبیق وضعیت پرداخت به شدت به فایل ها متکی است. Google Standard Payments هیچ فایلی ندارد. فراخوانی های API تا زمانی که وضعیت نهایی مشخص نشود، به طور نامحدود و نامحدود تکرار می شوند.

حالت های نهایی برای یک کلید ناتوانی خاصی واقعاً نهایی هستند. اشکالات و وضعیت‌های نامشخص به‌عنوان کاهش مدل‌سازی نمی‌شوند، بلکه به‌عنوان پاسخ‌های غیر 200 HTTP مدل‌سازی می‌شوند. این به ما این امکان را می‌دهد که باگ‌ها را سریع‌تر شناسایی کنیم و از پوشاندن آن‌ها به‌عنوان رد شدن اجتناب کنیم.

ویژگی های جدید

Google Standard Payments از ویژگی‌های جدید پشتیبانی می‌کند، از جمله:

  • Fraud API برای اطلاع دادن به موتور خطر Google از کلاهبرداران
  • API حساب مرتبط را به‌روزرسانی کنید تا Google را از تدارکات، محدودیت‌های تراکنش و تغییرات وضعیت حساب مطلع کنید
  • چالش احراز هویت بیشتر در هنگام خرید، مانند پین‌های USSD
  • چرخه حواله روزانه

نقشه اصطلاحات DCB3 به Google Payments Standard

در این مستندات و خود مشخصات، اصطلاحاتی را مشاهده خواهید کرد که جدید به نظر می رسد اما در واقع فقط کلمات متفاوتی برای مفاهیم موجود هستند.

  • حامل -> ادغام کننده پرداخت

هشدار: برای جلوگیری از سردرگمی با مفهوم یکپارچه‌کننده DCB، این سند سعی می‌کند از «ادغام‌کننده پرداخت» و «ادغام‌کننده DCB» به جای «ادغام‌کننده» استفاده کند. با این حال، اسناد کلی Google Standard Payments از "ادغام کننده" به طور آزادانه به عنوان مخفف "Payment Integrator" استفاده می کند.

  • شناسه قرارداد صورت‌حساب -> شناسه حساب یکپارچه‌ساز پرداخت
  • OperatorUserToken (OUT) -> GooglePaymentToken (GPT)
  • correlation_id -> requestId
  • Revshare -> هزینه

جریان احراز هویت

برای یک نمای کلی از جریان احراز هویت برای FOPهای Tokenized، این صفحه را ببینید .

مشخصات صورت‌حساب شرکت مخابراتی

برای صورت‌حساب شرکت مخابراتی، هدف جریان احراز هویت اثبات این است که کاربر کنترل سیم کارت متصل به حساب شرکت مخابراتی خود را در اختیار دارد. کاربران صورت‌حساب شرکت مخابراتی را می‌توان با استفاده از هر یک از این سه مکانیسم احراز هویت کرد:

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

مقایسه با DCB3

جریان احراز هویت، پاسخ تماس approveuser به Google را با OUT از مشخصات DCB3 جایگزین می‌کند.

در DCB3، احراز هویت و ارتباط در یک جریان واحد ترکیب شدند. در Google Standard Payments، احراز هویت یک نگرانی جدا از ارتباط حساب است.

جریان انجمن

برای یک نمای کلی از جریان ارتباط برای FOPهای توکن شده، به این صفحه مراجعه کنید .

تفاوت اصلی بین جریان ارتباطی که برای ابزارهای صورت‌حساب شرکت مخابراتی استفاده می‌شود و جریان عمومی FOPs Tokenized این است که اثبات احراز هویت ارائه شده در روش associateAccount بسته به اینکه آیا Payment Integrator یک چالش کاربر اضافی را درخواست کرده است متفاوت است.

اگر Payment Integrator پاسخ دهد که یک چالش کاربر اضافی را می‌خواهد، آن‌وقت اثبات احراز هویت، هر مدرکی برای اثبات هویت است که توسط مکانیزم احراز هویت خاصی که Google برای چالش اضافی استفاده می‌کند، ارائه می‌شود. به عنوان مثال، اثبات احراز هویت که توسط مکانیزم SMS-MT OTP تولید می شود، درخواست شناسه یک روش sendOtp به اضافه خود OTP است.

ویژگی های ابزار

بخش ویژگی‌های ابزار در نمای کلی توکن‌سازی شده FOP، مفهوم accountAlias ، accountNickname و fullAccountNickname را مورد بحث قرار می‌دهد.

مشخصات صورت‌حساب شرکت مخابراتی

  • accountAlias ​​باید شماره تلفن کاربر باشد. در صورت تماس کاربر با پشتیبانی Google در مورد حساب خود، از این ابزار برای کمک به شناسایی ابزار استفاده خواهد شد.
  • accountNickname و fullAccountNickname نام های نمایشی هستند که برای شناسایی ابزار در UI استفاده می شوند.

مقایسه با مشخصات DCB3

جریان ارتباطی جایگزین اجزای زیر از مشخصات DCB3 می شود:

  • تماس SOAP GetProvisioning
  • تماس SOAP GetSubscriberAddress
  • OUT تولید شده توسط حامل

یک تفاوت بزرگ در اینجا این واقعیت است که Google توکن Google Payment (GPT) را در جریان ارتباط ایجاد می کند به جای اینکه شرکت مخابراتی آن را تولید کند.

همچنین مهم است که توجه داشته باشید که برخلاف DCB3 که در آن OUT ها به یک BillingAgreementId خاص اختصاص داده می شوند، GPT به هیچ PaymentIntegratorAccountID خاصی اختصاص ندارد.

Refresh Token Flow

برای یک نمای کلی از جریان نشانه‌های تازه‌سازی برای FOPهای Tokenized، این صفحه را ببینید .

مشخصات صورت‌حساب شرکت مخابراتی

برای ابزارهای صورت‌حساب شرکت مخابراتی، ما به شدت از انقضای نشانه‌های پرداخت Google خودداری می‌کنیم زیرا منجر به لغو سفارش‌های اشتراک می‌شود. به‌جای انقضای نشانه‌ها و تکیه بر جریان نشانه‌های تازه‌سازی برای رفع آنها، موارد استفاده شما اغلب می‌تواند با استفاده از جریان به‌روزرسانی حساب که در زیر توضیح داده شده است، انجام شود.

جریان به روز رسانی حساب

جریان به‌روزرسانی حساب به Payment Integrator اجازه می‌دهد تا Google را از به‌روزرسانی‌های حساب یکپارچه‌ساز کاربر مطلع کند. این فیلدها در اصل در جریان ارتباط به Google ارائه می شوند. چند نمونه از داده‌های حساب که ممکن است Payment Integrator بخواهد به‌روزرسانی کند عبارتند از:

  • محدودیت تراکنش ماهانه، روزانه و هر مورد کاربر
  • وضعیت تامین حساب یکپارچه ساز کاربر
  • نوع حساب یکپارچه کننده کاربر (پیش پرداخت، پس پرداخت، سازمانی و غیره)
  • "accountAlias"، "accountNickname" یا "fullAccountNickname" کاربر
  • آیا کاربر یک پین ثابت از پیش به اشتراک گذاشته شده را تنظیم، حذف یا تغییر داده است
  • آیا کاربر حساب خود را بسته یا شماره تلفن خود را تغییر داده است -- ابزار کاربر را در سیستم Google باطل می کند.
  • حذف جریان توکن

مقایسه با مشخصات DCB3

جریان به‌روزرسانی حساب جایگزین اجزای زیر از مشخصات DCB3 می‌شود:

  • نظرسنجی تماس SOAP GetProvisioning
  • ابطال نشانه دوره ای

جریان خرید

برای یک نمای کلی از جریان خرید برای FOPهای توکن شده، این صفحه را ببینید .

مشخصات صورت‌حساب شرکت مخابراتی

برخی از شرکت‌های مخابراتی از USSD یا فناوری دیگری برای دریافت پین از کاربران خود در طول هر خرید استفاده می‌کنند. برای این حامل‌ها، به‌جای فراخوانی capture() asynchronousCapture را فراخوانی می‌کنیم و 30 ثانیه به حامل اجازه می‌دهیم تا از کاربر پین خود را بخواهد و ضبط را نهایی کند. وقتی وضعیت نهایی پرداخت مشخص شد، شرکت مخابراتی با فراخوانی captureResultNotification() نتیجه را به Google اطلاع می‌دهد.

مقایسه با مشخصات DCB3

در اینجا تغییرات اساسی وجود دارد.

  • فراخوانی متد منفرد و همزمان -- capture() به جای auth() + فایل دسته ای
  • هیچ فایل دسته ای وجود ندارد
  • بدون روش cancel() (capture + refund به جای auth + cancel)
  • هیچ فیلد user_message در پاسخ وجود ندارد -- کدهای رد با پیام های متعلق به Google که به زبان حساب کاربر بومی سازی شده اند نگاشت می شوند.
  • تغییرات کلیدی اصطلاحات:
    • CorrelationId -> requestId
    • BillingAgreementId -> paymentIntegratorAccountId
    • OperatorUserToken -> googlePaymentToken

جریان خرید به چالش کشیده

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

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

برای یک نمای کلی از جریان بازپرداخت برای FOPهای Tokenized، این صفحه را ببینید .

FOP توکن شده از جریان بازپرداخت پیام واحد پشتیبانی می کند. روش بازپرداخت از بازپرداخت یک خرید کامل یا بازپرداخت بخشی از خرید پشتیبانی می کند. بازپرداخت جزئی چندگانه می تواند یک خرید واحد را بازپرداخت کند.

مشخصات صورت‌حساب شرکت مخابراتی

در جریان بازپرداخت چیز خاصی در مورد ابزار صورتحساب شرکت مخابراتی وجود ندارد.

مقایسه با مشخصات DCB3

بازپرداخت با یک تماس API همزمان به جای یک فایل آغاز می شود. همچنین، بازپرداخت های چندگانه و جزئی را می توان برای یک پرداخت اصلی به جای پشتیبانی از بازپرداخت واحد و ارزش کامل ایجاد کرد.

جریان حواله

برای یک نمای کلی از جریان حواله برای FOPهای توکن شده، به این صفحه مراجعه کنید .

جریان حواله نحوه تسویه حساب Google و Payment Integrator است. گوگل سیستم حسابداری ثبت است و حسابداری برای انتقال حواله انجام می دهد. به طور منظم، Google صورت‌حواله‌ای را به Payment Integrator ارسال می‌کند. این بیانیه خلاصه‌ای از مبلغی را که Payment Integrator به Google بدهکار است به همراه دستورالعمل‌هایی در مورد نحوه پرداخت به Google ارائه می‌کند. برای اینکه Payment Integrator هماهنگ شود، Payment Integrator می تواند جزئیات سطح تراکنش را که بیانیه حواله را تشکیل می دهد از Google استعلام کند.

مشخصات صورت‌حساب شرکت مخابراتی

remittanceStatementDetails صورت‌حساب شرکت مخابراتی شامل فیلدهای اضافی است که هنوز در تعاریف API جریان حواله فهرست نشده‌اند. این شامل:

  • revshareCategory
  • قیمت آیتم
  • مالیات
  • مهر زمانی

برای شرکت‌هایی که قرارداد تقسیم اشتراک مجدد 50/50 با Google دارند، کارمزدهای ارائه شده در remittanceStatementDetails به‌جای ارائه بر اساس هر رویداد، در هر revshareCategory جمع‌آوری می‌شوند.

مقایسه با مشخصات DCB3

جریان حواله جایگزین مفاهیم زیر در مشخصات DCB3 می شود:

  • پی دی اف گزارش شارژ ماهانه/گزارش پرداخت
  • فایل CSV جزئیات فاکتور ماهانه
  • بازیابی روزانه فایل های CSV

تفاوت عمده در اینجا حذف هر گونه فایل و پشتیبانی از حواله های روزانه است. به جای فایل‌ها، مبلغ برای ارسال از طریق یک API همزمان تحویل داده می‌شود و یک API دیگر از پرس و جو برای جزئیات در مورد بیانیه حواله پشتیبانی می‌کند.

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

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

مشخصات صورت‌حساب شرکت مخابراتی

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