Mulai Alur Pengalihan

Pengalihan pembayaran dapat dimulai dengan dua cara yang berbeda:

  1. Saat memilih "Alihkan pembayaran", pengguna akan dialihkan ke situs integrator untuk memilih Form-Of-Payment (FOP) yang akan digunakan. Dalam hal ini, noFopChosen akan diisi dalam permintaan. Jika hal ini terjadi, integrator akan menampilkan daftar penerbit yang tersedia kepada pengguna. Setelah pengguna memilih salah satu opsi ini, pengguna akan diteruskan ke situs/aplikasi penerbit untuk menyelesaikan pembelian.

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

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

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

Integrator harus mendukung panjang URL 2.048 karakter. Hal ini termasuk skema, host, port, jalur, dan parameter. Semua parameter akan dienkode UTF-8 sebelum dienkode ke URL.

Permintaan Pengalihan

Berikut contoh URL tempat pengguna akan dialihkan sebagai bagian dari alur Mulai Pengalihan (juga dikenal sebagai 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 dalam 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 saat pembayaran selesai. Nilai ini dienkode ke URL dan memiliki panjang maksimum 512 karakter.

URL ini akan menyertakan requestId dari redirectRequest terenkripsi dalam parameter GET redirectRequestId. Vendor harus memvalidasi bahwa redirectRequestId dari callbackUrl dan requestId dari payload terenkripsi identik untuk memverifikasi bahwa keduanya terkait.

redirectRequest RedirectRequest

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