Alur Pengalihan Lengkap

Ringkasan

Alur Pengalihan Lengkap dimulai setelah alur Mulai Pengalihan selesai dan pengguna melakukan pembayaran di antarmuka web penerbit. Tujuan alur Pengalihan Lengkap adalah untuk:

1. Beri tahu Google dan integrator pembayaran bahwa pembayaran berhasil.
2. Alihkan pengguna kembali ke Google, melalui integrator.

Cara kerja alurnya

Ada tiga cara berbeda yang dapat digunakan integrator untuk mengirimkan informasi pembayaran yang telah selesai ke Google.

1. Integrator mengalihkan pengguna ke Google, dan menambahkan informasi pembayaran ke respons pengalihan.
2. Integrator mengirimkan permintaan HTTPS ke endpoint RedirectPaymentCompleteNotification Google setelah pembayaran selesai.
3. Google mengirimkan permintaan HTTPS ke endpoint GetRedirectPaymentStatus integrator, dan integrator merespons dengan detail pembayaran.

Catatan: Alur #3 hanya dipanggil jika permintaan akan kehabisan waktu tunggu dan tidak ada respons yang diterima.

Selesaikan alur Pengalihan

Diagram urutan berikut menunjukkan interaksi antara browser pengguna, Google, integrator, dan penerbit:

Catatan: Penerbit dan integrator pembayaran dapat merupakan entitas yang sama, dalam hal ini satu pengalihan ke Google sudah cukup.

Berikut adalah daftar objek dalam diagram di atas:

• Pengguna: Ini adalah orang yang menyelesaikan pembayaran.
• UI Google: Antarmuka web atau aplikasi Google, tempat pelanggan memulai pembayaran.
• Server Google: Server backend di Google yang mendapatkan detail pembayaran lengkap dan memberikan barang atau layanan yang dibeli kepada pengguna.
• Integrator Pembayaran: Integrator pembayaran yang akan bertindak sebagai perantara antara Google dan penerbit.
• Penerbit: Penerbit tempat pengguna melakukan pembayaran.

Kami berasumsi bahwa pengguna baru saja selesai melakukan pembayaran di situs penerbit, yang memicu alur Pengalihan Lengkap.

1. Pengguna menyelesaikan pembayaran di portal penerbit.
2. Penerbit membuat URL alihan yang mengarah ke integrator dengan informasi tentang pembayaran yang telah diselesaikan.
3. Penerbit mengalihkan pengguna ke server backend integrator pembayaran.
4. Integrator pembayaran membuat respons pengalihan menggunakan informasi dari pengalihan penerbit.
5. Integrator pembayaran mengalihkan pengguna ke Google.
6. Integrator pembayaran mengirimkan RedirectPaymentCompleteNotification ke Google. Hal ini digunakan jika pengalihan gagal setelah pengguna menyelesaikan pembayaran.
7. Jika Google tidak menerima respons pengalihan atau RedirectPaymentCompleteNotification, Google akan mengirimkan panggilan GetRedirectPaymentStatus ke integrator pembayaran, yang akan merespons dengan informasi status pembayaran.
8. Google memproses informasi pembayaran untuk menyediakan barang atau layanan yang dibeli kepada pengguna.

Notifikasi Pengalihan Pembayaran Selesai

Seperti yang ditunjukkan dalam diagram di atas, Google mewajibkan integrator untuk mengirim RedirectPaymentCompleteNotification ke Google saat integrator menentukan bahwa pembayaran pengalihan telah diterima atau ditolak. Notifikasi ini dapat dikirimkan ke Google sebelum atau setelah pengguna dialihkan kembali ke Google.

Jika integrator mengetahui penyelesaian (diterima atau ditolak) pembayaran pengalihan bahkan beberapa hari setelah pengalihan dimulai, integrator tetap harus mengirimkan RedirectPaymentCompleteNotification ke Google. Notifikasi ini membantu memperbarui status akhir tentang pembayaran dan diperlukan untuk menangani rekonsiliasi dengan benar.

Praktik terbaik dan pertimbangan lainnya

Langkah-langkah keamanan

URL respons pengalihan akan menyertakan kolom redirectRequestId yang tidak dienkripsi, dan objek RedirectResponse terenkripsi dengan nilai yang sama. Google akan memvalidasi bahwa kedua nilai ini cocok dengan kolom requestId yang dikirim dalam permintaan pengalihan.

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