Mulai Alur Pengalihan

Pengalihan pembayaran dapat dimulai dengan dua cara:

  1. Bila pengguna memilih "Alihkan pembayaran", mereka akan dialihkan ke situs integrator Anda untuk memilih Formulir-Pembayaran (FOP) yang akan digunakan. Di sini ini, noFopChosen akan diisi dalam permintaan. Ketika ini terjadi, integrator akan menampilkan kepada pengguna daftar penerbit yang tersedia. Satu kali pengguna memilih salah satu, pengguna akan diteruskan ke situs/aplikasi Anda untuk menyelesaikan pembelian.

  2. Pengguna akan memilih FOP (penerbit) selama alur pembelian. Dalam kasus ini, Google akan mengisi issuerId dalam permintaan dan mengalihkan pengguna ke integrator. Jika integrator menerima ini, mereka harus segera mengarahkan pengguna ke situs/aplikasi penerbit untuk menyelesaikan pembelian.

Dalam kedua kasus di atas, Google akan mengalihkan pengguna langsung ke situs web integrator tanpa panggilan server ke server sebelumnya dari Google.

Integrator harus mengimplementasikan protokol HTTPS menggunakan GET. Parameter GET yang diuraikan dalam Parameter Permintaan Pengalihan, akan berisi informasi tentang pembayaran pengalihan yang diminta.

Integrator harus mendukung panjang URL 2.048 karakter. Pembaruan ini mencakup skema, {i>host<i}, porta, jalur dan parameter. Semua parameter akan dienkode dengan UTF-8 sebelum dienkode ke URL.

Permintaan Pengalihan

Berikut ini contoh URL tempat pengguna akan dialihkan sebagai bagian dari Mulai alur Pengalihan (disebut juga permintaan pengalihan):

https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H

Nilai parameter callbackUrl yang didekode URL dalam contoh ini adalah:

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE

Parameter redirectRequest dienkripsi dan ditandatangani menggunakan PGP atau JWE+JWS sebelum dienkode base64url.

Parameter Permintaan Pengalihan

Permintaan GET HTTPS harus memiliki parameter kueri berikut:

Kolom
callbackUrl string

URL untuk mengalihkan pengguna ke saat pembayaran selesai. Nilai ini dienkode ke URL dan memiliki panjang maksimal 512 karakter.

URL ini akan menyertakan requestId dari redirectRequest di redirectRequestId GET . Vendor harus memvalidasi bahwa redirectRequestId dari callbackUrl dan requestId dari payload terenkripsi sama dengan memverifikasi bahwa keduanya saling terkait.

redirectRequest RedirectRequest

WAJIB: RedirectRequest harus dienkripsi dan ditandatangani menggunakan PGP atau JWE+JWS. Selain itu, nilai ini harus aman bagi web base64 dienkode.