metode pembayaran tunai

Ringkasan

Google Standard Payments mendukung FOP (metode pembayaran) berbasis tunai seperti pembelian di minimarket (seperti 7-Eleven). Pada tingkat tinggi, pengguna yang ingin membayar barang menghasilkan nomor referensi melalui Integrator pembayaran. Pengguna kemudian membawa nomor referensi ini ke minimarket, kios, atau bank dan membayar nomor referensi.

Menambahkan pembayaran
1) Pengguna menambahkan metode pembayaran
Pilih tempat pembayaran
2) Kemudian, mereka memilih tempat pembayaran
Petunjuk pembayaran
3) Terakhir, mereka akan diberi petunjuk pembayaran

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

Google menggunakan dua alur utama untuk membuat dan membayar nomor referensi ini:

  1. Membuat Alur Nomor Referensi.
  2. Alur Nomor Referensi Pay.

Kemudian, rekonsiliasi dan penyelesaian dari pembelian yang dihasilkan ditangani oleh alur transfer dana.

Diagram di bawah menggambarkan setiap alur ini.

Ringkasan metode pembayaran tunai

Ringkasan tingkat tinggi metode pembayaran tunai

Dua alur pertama dijelaskan secara lebih mendetail di bagian berikut. Lihat halaman Alur pembayaran jika Anda ingin mengetahui alur tersebut lebih lanjut.

Buat nomor referensi

Tujuan dari alur pembuatan nomor referensi adalah untuk membuat dan menukar ID (nomor referensi) yang dapat digunakan Google dan integrator untuk mengidentifikasi pembelian. Pengguna kemudian dapat menggunakan nomor referensi ini di minimarket, kios, atau bank untuk menyelesaikan pembelian. ID ini dibuat oleh integrator atas permintaan Google dengan memanggil metode generateReferenceNumber. Permintaan pembuatan nomor referensi mencakup jumlah dan deskripsi transaksi.

Diagram berikut menggambarkan cara nomor referensi dibuat dan dikirim ke pelanggan dengan petunjuknya.

Buat alur nomor referensi

Nomor Referensi Hasil Tunai

Berikut adalah daftar objek dan artinya:

  • Pengguna: Ini adalah orang yang ingin membayar sesuatu menggunakan metode pembayaran ini.
  • UI Google: Ini adalah antarmuka tempat Pengguna melakukan pembelian. Bantuan bisa melalui web atau aplikasi.
  • Server Google: Server backend di Google yang meminta pembuatan nomor referensi dan membuat petunjuk pembayaran untuk pengguna.
  • Server Integrator Pembayaran: Server backend Integrator Pembayaran yang melacak detail pembayaran dan menghasilkan nomor referensi.

Alur ini dimulai dengan pengguna yang ingin menggunakan metode pembayaran tunai ini.

  1. Pengguna mengakses UI Google yang mengirim permintaan nomor referensi.
  2. UI Google mengirim pesan ke Server Google bahwa nomor referensi (getReferenceNumber) diperlukan.
  3. Server Google meminta Server Integrator Pembayaran untuk membuat nomor referensi (generateReferenceNumber).
  4. Server Integrator Pembayaran membuat dan mengirim nomor referensi ke Server Google.
  5. Server Google membuat petunjuk pembayaran yang disertakan dengan nomor referensi. Kemudian, kode tersebut mengirimkan informasi ini ke UI Google.
  6. UI Google mengirimkan petunjuk dan nomor referensi ini kepada Pengguna.

Catatan tentang nomor referensi

Nomor referensi hanya dapat dibayar sekali, dan dapat dibatalkan melalui alur pembatalan nomor referensi. Selain itu, nomor referensi harus berupa alfanumerik dan harus mendukung berbagai format tampilan.

Selain menampilkan nomor referensi, UI Google dapat secara opsional mewakili nomor referensi dalam format Kode 128 (format kode batang). Format kode batang lainnya dapat didukung berdasarkan permintaan.

Nomor Referensi Pay

Pengguna akan menggunakan nomor referensi ini di minimarket, kios, atau bank untuk mengidentifikasi pembelian yang ingin dibayar pengguna. Integrator harus meminta pengguna mengonfirmasi bahwa pembelian telah dibayar dengan menampilkan jumlah pembelian, tanggal, dan deskripsi transaksi sebelum membayar.

Setelah pengguna memilih untuk membayar, mereka harus membayar penuh, dan hanya membayar sekali. API ini tidak mendukung kelebihan atau kekurangan pembayaran pada satu nomor referensi. Beberapa pembayaran ke satu nomor referensi juga tidak didukung.

Setelah pengguna membayar, integrator harus segera memberi tahu Google bahwa nomor referensi ini telah dibayar melalui metode referenceNumberPaidNotification. Dengan memanggil metode ini dalam hitungan detik setelah pengguna membayar secara fisik, integrator memungkinkan pengguna menerima barang mereka dengan cepat. (Panggilan ini dapat ditambahkan ke antrean jika jaringan sedang mati.)

Setelah dibayar, nomor referensi dan jumlah akan disertakan dalam laporan mutasi pembayaran yang dikirim pada T+2 hari.

Berikut adalah diagram urutan yang menggambarkan pembayaran nomor referensi.

Alur nomor referensi pembayaran

Alur nomor referensi pembayaran

Objek dalam diagram mewakili hal berikut:

  • Pengguna: Ini adalah orang yang ingin membayar sesuatu menggunakan metode pembayaran ini.
  • Minimarket: Lokasi tempat pengguna melakukan pembayaran menggunakan nomor referensi dan petunjuk yang diberikan, seperti minimarket.
  • Server Integrator Pembayaran: Server backend Integrator Pembayaran yang melacak detail pembayaran.
  • Server Google: Server backend di Google yang meminta pembuatan nomor referensi dan membuat petunjuk pembayaran untuk pengguna.

Alur ini dimulai dengan pengguna yang pergi ke minimarket untuk melakukan pembayaran sesuai dengan instruksi yang diberikan kepada mereka.

  1. Pengguna pergi ke Minimarket untuk melakukan pembayaran.
  2. Setelah transaksi selesai, minimarket akan memberi tahu integrator pembayaran tentang pembayaran.
  3. Server Integrator Pembayaran mengirim pesan berhasil ke Minimarket.
  4. Minimarket menyampaikan bahwa transaksi berhasil kepada Pengguna, dan barang akan segera dikirimkan kepada Pengguna.
  5. Server Integrator Pembayaran mengirim pesan ke Server Google bahwa nomor referensi telah dibayar (referenceNumberPaidNotification). Langkah ini tidak boleh memblokir langkah 4.
  6. Server Google merespons dengan pesan keberhasilan ke Server Integrator Pembayaran.

Batalkan nomor referensi

Nomor referensi dapat dibatalkan oleh Google. Jika Google membatalkan nomor referensi, metode cancelReferenceNumber akan dipanggil. Setelah panggilan kembali berhasil, Anda tidak dapat membayar nomor referensi tersebut, dan integrator harus menolak pembayaran untuk nomor ini. Setelah berhasil melakukan panggilan ini, semua panggilan berikutnya ke referenceNumberPaidNotification akan gagal.

Jika proses pembayaran sudah dimulai, misalnya jika pengguna telah memasukkan nomor referensi ke kios tetapi belum membayar, integrator harus menampilkan kode respons HTTP 423 dengan ErrorResponse yang berisi USER_ACTION_IN_PROGRESS.

Berikutnya: Alur pembayaran