Web Up-Up API

یکپارچه‌سازها باید یک میزبان وب را برای تغییر مسیر کاربران برای اهداف بالا اجرا کنند. این شارژ یک روش متفاوت است، اما همان هدفی است که شارژ کردن توسط Android Top-ups ارائه شده است. این میزبان وب باید یک وب سایت سازگار با موبایل داشته باشد.

میزبان وب باید درخواست های وب تلفن همراه را در مقابل درخواست های وب دسکتاپ بر اساس مقدار هدر کاربر-عامل تعیین کند. صفحه‌ای که در درخواست‌های وب تلفن همراه ارائه می‌شود باید در Android و iOS سازگار با وب‌سایت همراه باشد. علاوه بر مقدار هدر user-agent، کلاینت هیچ راهنمایی دیگری در مورد محیطی که کاربر در آن درخواست می کند (دسکتاپ یا وب) به شما ارائه نمی دهد.

سرور باید یک پروتکل HTTPS را با استفاده از GET پیاده سازی کند. مسیر و میزبان توسط یکپارچه کننده قابل تعریف هستند. ادغام کننده باید از طول URL 2048 کاراکتر پشتیبانی کند. این شامل طرح، میزبان، پورت، مسیر و پارامترها است.

همه پارامترها قبل از کدگذاری URL با UTF-8 کدگذاری خواهند شد.

درخواست

در صورت درخواست، گوگل موارد زیر را به عنوان پارامترهای URL ارائه می دهد:

زمینه های
gspMajorVersion int

شماره نسخه اصلی برای این درخواست.

gspTopUpRequest TopUpRedirectRequest

درخواست شارژ

gspAssociationId string

حاوی شناسه‌ای است که یکپارچه‌ساز برای جستجوی اعتبار حسابی که کاربر در حال تکمیل آن است استفاده می‌کند. این شناسه ارتباطی است که هنگام پیوند دادن حساب در AssociateAccountRequest ارسال می‌شود.

gspCallbackUrl string

نشانی اینترنتی جهت هدایت کاربر به جهت تکمیل جریان شارژ در Google. این مقدار url کدگذاری شده است.

واکنش

پس از تکمیل شارژ، کاربر باید با استفاده از HTTPS GET به gspCallbackUrl هدایت شود. این URL باید پارامترهای پرس و جو زیر را داشته باشد:

زمینه های
gspResult int

100
شارژ با موفقیت انجام شد.
201 کاربر جریان را به صورت دستی لغو کرد و جریان باید قطع شود.
202 شارژ به دلیل مرگبار انجام نشد و جریان باید متوقف شود.
redirectRequestId string

REQUIRED : requestId در درخواست پرداخت تغییر مسیر اصلی/شروع ارسال شد. Google تأیید خواهد کرد که این مورد با requestId ارسال شده مطابقت دارد و اگر مطابقت نداشته باشد، جریان تغییر مسیر کامل ناموفق خواهد بود.
gspTopUpResponse RedirectResponse

مورد نیاز : TopUpRedirectResponse باید با استفاده از PGP یا JWE+JWS رمزگذاری و امضا شود. علاوه بر این، این مقدار باید به صورت web-safe base64 کدگذاری شود.