Alihkan FOP
Ringkasan
Google Standard Payments mendukung Metode Pembayaran (FOP) berbasis pengalihan. FOP pengalihan memungkinkan pengguna produk atau layanan Google membayarnya di antarmuka web entitas eksternal. Pada tingkat tinggi, pengguna yang ingin membayar barang awalnya dialihkan ke integrator pembayaran atau ke penerbit yang tersedia melalui integrator pembayaran. Jika pengguna dialihkan ke integrator, integrator harus meneruskan pengguna ke antarmuka web penerbit untuk menyelesaikan pembelian. Setelah pembayaran selesai, pengguna akan dialihkan kembali ke Google melalui integrator.
Google menggunakan dua alur utama untuk menyelesaikan pembayaran FOP pengalihan:
- Mulai pengalihan: Ada dua alur berbeda yang dapat memulai pembayaran pengalihan. Integrator pembayaran hanya boleh menerapkan salah satu opsi berikut:
- Memulai alur Pengalihan: Memulai pembayaran dengan mengalihkan pengguna ke integrator pembayaran.
- Buat alur URL Pembayaran Pengalihan: Google memulai pembayaran dengan mengirimkan permintaan server ke server ke integrator pembayaran untuk membuat URL pembayaran pengalihan. Berdasarkan respons tersebut, Google mengalihkan pengguna langsung ke penerbit.
- Selesaikan alur Pengalihan: Setelah pengguna menyelesaikan pembelian, integrator akan menggunakan alur ini untuk mengonfirmasi pembayaran dengan Google.
Terakhir, semua perpindahan uang antara bank integrator dan bank Google dilakukan dalam alur transfer dana.
Ringkasan FOP pengalihan
Gambar berikut mengilustrasikan ringkasan alur secara luas:
Secara umum, menambahkan layanan Anda sebagai metode pembayaran ke produk Google melibatkan alur berikut:
- Mulai Pengalihan:
- Selesaikan alur Pengalihan
- Alur pengembalian dana
- Alur transfer dana
Konsep dan terminologi
Simbol & Konvensi
Kata kunci "HARUS", "HARUS", "WAJIB", "DIPERLUKAN", "SEHARUS", "TIDAK BOLEH", "SEHARUS", "SEHARINYA", "DIREKOMENDASIKAN", "DAPAT", dan "OPSIONAL" dalam dokumen-dokumen ini harus ditafsirkan sebagaimana dijelaskan dalam RFC 2119.
Stempel waktu
Semua stempel waktu direpresentasikan sebagai milidetik sejak epoch Unix (1 Jan 1970) dalam UTC.
Contoh:
- 23 April 2019 20.23.25 GMT = 1556051005000 milidetik
- 16 Agustus 2018 12.28.35 GMT = 1534422515000 milidetik
Jumlah
Nilai uang dalam API ini menggunakan format yang disebut "micros", sebuah standar di Google. Mikro adalah format presisi tetap yang berbasis bilangan bulat. Untuk mewakili nilai uang dalam mikro, kalikan nilai mata uang standar dengan 1.000.000.
Contoh:
- USD$1,23 = 1230000 USD mikro
- USD$0,01 = 10.000 USD mikro
Idempotensi
Semua panggilan metode dalam API ini harus memiliki perilaku idempoten. Google akan mencoba kembali permintaan secara sporadis untuk memastikan bahwa transaksi berada dalam status yang sama di kedua sisi. Integrator tidak boleh mencoba memproses ulang permintaan apa pun yang telah berhasil diproses. Respons untuk pemrosesan yang berhasil harus dilaporkan. Semua metode memiliki RequestHeader umum yang berisi requestId. requestId ini adalah kunci idempotensi untuk semua panggilan.
Semua respons non-terminal (non-HTTP 200-sukses), tidak boleh diproses secara idempoten. Jadi, permintaan yang sebelumnya mendapat 400 (permintaan buruk/prakondisi gagal), saat dipanggil untuk kedua kalinya, tidak boleh secara idempoten menampilkan 400, permintaan tersebut harus dievaluasi ulang. Saat dievaluasi ulang, angka 400 dapat muncul atau berhasil diproses.
Untuk mengetahui informasi selengkapnya tentang idempotensi, lihat panduan mendetail ini.
Integrator
Perusahaan yang menggunakan Platform Pembayaran Google untuk bisnis mereka. Bisnis ini bisa saja internal (1P), seperti YouTube atau AdWords. Ini juga bisa berupa bisnis eksternal (3P) yang ingin mengintegrasikan layanan mereka agar berfungsi dengan ekosistem Google.
FOP
Metode Pembayaran. Ini lebih umum daripada instrumen. Visa, MasterCard, dan PayPal semuanya adalah FOP.
Instrumen
Contoh metode pembayaran tertentu oleh pelanggan tertentu. Misalnya, kartu kredit pengguna atau akun PayPal mereka. FOP dengan token untuk pelanggan tertentu juga merupakan instrumen, karena merupakan contoh metode pembayaran untuk pelanggan tersebut, yang disimpan dengan aman di sistem kami.
Token
Representasi metode pembayaran pengguna tertentu, di sistem Google. Karena berisi semua informasi yang diperlukan untuk melakukan pembelian, token juga merupakan instrumen. Informasi ini dapat mencakup informasi seperti nomor akun yang dimiliki pengguna dengan integratornya.
Alur kunci
Mulai alur Pengalihan
Langkah pertama dalam pembayaran pengalihan adalah alur Mulai Pengalihan. Tujuan alur Mulai Pengalihan adalah untuk mengalihkan pengguna, melalui integrator, ke antarmuka web penerbit yang mereka pilih sehingga mereka dapat memberikan otorisasi pembayaran. Setelah pengalihan, Google akan memberikan informasi transaksi dasar kepada integrator, yang kemudian akan meneruskannya kepada penerbit.
Untuk informasi selengkapnya, lihat bagian Mulai alur Pengalihan.
Selesaikan alur Pengalihan
Setelah berada di antarmuka web penerbit, pengguna harus melakukan semua langkah yang diperlukan untuk menyelesaikan pembayaran (langkah ini dapat berubah bergantung pada penerbit). Sebagai bagian dari alur Pengalihan Selesai, penerbit harus mengalihkan pengguna kembali ke integrator dengan informasi tentang pembayaran yang berhasil. Kemudian, integrator akan mengalihkan pengguna kembali ke Google, termasuk detail pembayaran sebagai bagian dari respons pengalihan. Setelah pembayaran dikonfirmasi, Google akan menyediakan barang atau layanan yang dibeli kepada pengguna.
Untuk informasi selengkapnya, lihat bagian Alur Pengalihan Selesai.