Integrator harus menerapkan host web untuk mengalihkan pengguna untuk menambah saldo. Penambahan saldo ini adalah modalitas yang berbeda, tetapi memiliki tujuan yang sama dengan penambahan saldo yang disediakan oleh Penambahan Saldo Android. Host web ini harus memiliki situs yang mobile-friendly.
Host web harus menentukan permintaan web seluler vs permintaan web desktop berdasarkan nilai header agen pengguna. Halaman yang ditayangkan di permintaan web seluler harus mobile-friendly di Android dan iOS. Selain nilai header agen pengguna, klien tidak akan memberikan petunjuk lain tentang lingkungan tempat pengguna ini membuat permintaan (desktop atau web).
Server harus menerapkan protokol HTTPS menggunakan GET. Jalur dan {i>host<i} dapat ditentukan oleh integrator. Integrator harus mendukung panjang URL 2.048 karakter. Ini termasuk skema, host, port, jalur, dan parameter.
Semua parameter akan dienkode UTF-8 sebelum dienkode ke URL.
Permintaan
Berdasarkan permintaan, Google memberikan hal berikut sebagai parameter URL:
| Kolom | |
|---|---|
gspMajorVersion
|
int
Nomor versi utama untuk permintaan ini. |
gspTopUpRequest
|
TopUpRedirectRequest
Permintaan penambahan saldo. |
gspAssociationId
|
string
Berisi ID yang digunakan integrator untuk mencari kredensial untuk akun yang diisi ulang oleh pengguna. Ini adalah ID pengaitan yang dikirim selama penautan akun di AssociateAccountRequest. |
gspCallbackUrl
|
string
URL yang akan menjadi tujuan pengalihan pengguna untuk menyelesaikan alur penambahan saldo di Google. Nilai ini dienkode URL. |
Respons
Setelah menyelesaikan penambahan saldo, pengguna harus dialihkan ke
gspCallbackUrl menggunakan HTTPS GET. URL ini harus memiliki parameter kueri berikut:
| Kolom | |||||||
|---|---|---|---|---|---|---|---|
gspResult
|
int
|
||||||
| redirectRequestId |
string WAJIB: requestId yang dikirim dalam permintaan pembayaran pengalihan awal/memulai. Google akan memverifikasi bahwa ini cocok dengan requestId yang dikirim, dan alur Pengalihan Lengkap akan gagal jika tidak cocok.
|
||||||
gspTopUpResponse |
WAJIB: TopUpRedirectResponse harus dienkripsi dan ditandatangani menggunakan PGP atau JWE+JWS. Selain itu, nilai ini harus dienkode base64 yang aman untuk web. |
||||||