Pengantar Google Standard Payments untuk Operator

Di dunia Google Pembayaran Standar, Tagihan Operator dianggap sebagai metode pembayaran (FOP) dengan token, artinya Google dan Integrator Pembayaran melakukan pertukaran kredensial identitas akun satu kali untuk membuat token. Selanjutnya, token ini ditunjukkan kembali ke Integrator Pembayaran untuk mengidentifikasi akun yang akan ditagih.

Metode pembayaran lain juga menggunakan tokenisasi. Oleh karena itu, kami memiliki ringkasan umum tentang FOP dengan Token yang sebagian besar relevan dengan Penagihan Operator. Alur Autentikasi, Pengaitan, Pembelian, dan Pembayaran dijelaskan secara lebih mendetail dalam ringkasan tersebut. Halaman ini memberikan detail selengkapnya dalam konteks khusus Tagihan Operator.

Operator melakukan aktivasi Google Standard Payments dengan mengimplementasikan API yang membentuk alur berikut:

Flow Deskripsi Setara Spesifikasi DCB3
Autentikasi Mengidentifikasi dan mengautentikasi akun pengguna di sistem Payment Integrator yang akan digunakan untuk melakukan pembayaran DCB SMS-MO dengan GoogleUserToken
Pengaitan Menukar token yang berlaku lama yang telah disetujui Google dan Payment Integrator dapat digunakan untuk melakukan pembayaran menggunakan akun Payment Integrator pengguna callback setujui pengguna dengan OperatorUserToken dan GetPenyedia()
FundsTransfer Memindahkan dana dari akun Payment Integrator pengguna secara bersamaan. Mentransfer kewajiban ke Integrator Pembayaran baris Auth() dan CHARGE dalam file permintaan batch
Pengembalian Dana Secara bersamaan mengembalikan beberapa atau semua dana yang terkait dengan Transfer Dana sebelumnya ke akun Payment Integrator pengguna. Mentransfer kewajiban ke Google baris PENGEMBALIAN DANA dalam file permintaan batch
Transfer dana Penyelesaian berbasis API, sebaiknya setiap hari PDF faktur bulanan, file detail faktur bulanan, file pengintaian harian
UpdateAssociatedAccount Memberi tahu Google tentang perubahan pada akun Integrator Pembayaran pengguna (misalnya, batas transaksi atau status penyediaan) Jajak pendapat GetPenyedia()
Penipuan Memberi tahu Google tentang transaksi yang dibatalkan karena sengketa pengguna. Hal ini digunakan untuk meningkatkan mesin risiko Google, tetapi tidak memengaruhi kewajiban uang Tidak ada

Perbandingan Keseluruhan dengan Spesifikasi DCB3

Spesifikasi Google Standard Payments memecahkan masalah yang sama dengan yang diselesaikan oleh Spesifikasi DCB3. Namun, model ini menggunakan berbagai teknologi dan desain API yang meningkatkan solusi. Berikut ini perbedaan utama secara sekilas:

Perbandingan Teknologi Stack

Semua komunikasi API dilakukan menggunakan POST HTTPS dengan JSON bertanda tangan dan terenkripsi PGP. Artinya, Google dan Integrator Pembayaran masing-masing hanya memiliki satu kunci PGP untuk dirotasi. Teknologi ini juga memiliki dukungan yang lebih baik daripada SOAP. Detail selengkapnya tentang stack komunikasi dapat ditemukan di sini.

Perbandingan Filosofi API

DCB3 sangat bergantung pada file untuk merekonsiliasi status pembayaran. Google Standard Payments tidak memiliki file. Panggilan API dicoba ulang secara idempoten dan tanpa batas waktu hingga status akhir ditentukan.

Status akhir benar-benar final untuk kunci idempotensi tertentu. Bug dan status tidak pasti tidak dimodelkan sebagai penolakan, melainkan sebagai respons HTTP non-200. Dengan begitu, kami dapat mendeteksi bug lebih cepat dan menghindari menyamarkannya sebagai penolakan.

Fitur Baru

Google Pembayaran Standar mendukung fitur-fitur baru, yang meliputi:

  • Fraud API untuk menginformasikan mesin risiko Google mengenai penipu
  • Mengupdate Associated Account API untuk memberi tahu Google tentang perubahan penyediaan, batas transaksi, dan status akun
  • Lebih banyak dukungan tantangan autentikasi selama pembelian, seperti PIN USSD
  • Siklus transfer dana harian

Peta Terminologi Pembayaran Standar DCB3 ke Google

Dalam dokumentasi ini dan spesifikasinya sendiri, Anda akan melihat terminologi yang terlihat baru, tetapi sebenarnya hanyalah kata yang berbeda untuk konsep yang sudah ada.

  • Operator -> Integrator Pembayaran

PERINGATAN: Untuk menghindari kebingungan dengan konsep integrator DCB, dokumen ini mencoba menggunakan "Payment Integrator" dan "DCB integrator" bukan hanya "integrator". Namun, dokumentasi umum Google Standard Payments menggunakan "integrator" secara bebas sebagai singkatan untuk "Payment Integrator"

  • ID Perjanjian Penagihan -> ID Akun Integrator Pembayaran
  • OperatorUserToken (KELUAR) -> GooglePaymentToken (GPT)
  • correlation_id -> requestId
  • Pembagian keuntungan -> biaya

Alur Autentikasi

Untuk ringkasan umum tentang alur autentikasi untuk FOP dengan Token, lihat halaman ini.

Detail Tagihan Operator

Untuk Tagihan Operator, sasaran alur autentikasi adalah untuk membuktikan bahwa pengguna memiliki kontrol atas kartu SIM yang terkait dengan akun operator mereka. Pengguna Tagihan Operator dapat diautentikasi menggunakan salah satu dari tiga mekanisme berikut:

Integrator Pembayaran dapat bekerja sama dengan Google untuk memilih mekanisme autentikasi yang paling sesuai dengan produk mereka.

Perbandingan dengan DCB3

Alur autentikasi mengganti callback approveuser ke Google tanpa spesifikasi DCB3.

Di DCB3, autentikasi dan pengaitan digabungkan ke dalam satu alur. Di Google Standard Payments, autentikasi adalah masalah yang terpisah dari pengaitan akun.

Alur Pengaitan

Untuk ringkasan umum tentang alur pengaitan untuk FOP dengan Token, lihat halaman ini.

Perbedaan utama antara alur pengaitan yang digunakan untuk instrumen Penagihan Operator dan alur FOP dengan Token umum adalah bukti autentikasi yang diberikan dalam metode associateAccount akan bervariasi bergantung pada apakah Integrator Pembayaran meminta verifikasi pengguna tambahan atau tidak.

Jika Integrator Pembayaran merespons bahwa ia menginginkan tantangan pengguna tambahan, bukti autentikasinya adalah bukti identitas apa pun yang dihasilkan oleh mekanisme autentikasi tertentu yang digunakan Google untuk verifikasi verifikasi tambahan. Misalnya, bukti autentikasi yang dihasilkan oleh mekanisme OTP SMS-MT adalah requestId metode sendOtp ditambah OTP itu sendiri.

Atribut Instrumen

Bagian Atribut Instrumen dari ringkasan FOP dengan Token umum membahas konsep accountAlias, accountNickname, dan fullAccountNickname.

Detail Tagihan Operator

  • accountAlias harus berupa nomor telepon pengguna. Informasi ini akan digunakan untuk membantu mengidentifikasi instrumen jika pengguna memanggil dukungan Google terkait akun mereka.
  • accountNickname dan fullAccountNickname adalah nama tampilan yang digunakan untuk mengidentifikasi instrumen di UI.

Perbandingan dengan Spesifikasi DCB3

Alur asosiasi menggantikan komponen spesifikasi DCB3 berikut:

  • Panggilan Dapatkan SOAP Penyediaan
  • Panggilan SOAP GetSubscriberAddress
  • KELUAR yang dihasilkan operator

Perbedaan besar di sini adalah fakta bahwa Google menghasilkan Token Pembayaran Google (GPT) selama alur pengaitan, bukan operator yang membuatnya.

Penting juga untuk diperhatikan bahwa tidak seperti di DCB3 saat OUT tercakup ke BillingAgreementId tertentu, GPT tidak dicakupkan ke PaymentIntegratorAccountID tertentu.

Muat Ulang Alur Token

Untuk mengetahui ringkasan umum tentang alur token refresh untuk FOP dengan Token, lihat halaman ini.

Detail Tagihan Operator

Untuk instrumen Tagihan Operator, sebaiknya masa berlaku Token Google Payments habis karena dapat menyebabkan pesanan langganan dibatalkan. Daripada menggunakan token yang akan habis masa berlakunya dan mengandalkan alur token refresh untuk memperbaikinya, kasus penggunaan Anda sering kali dapat diselesaikan menggunakan alur update akun yang dijelaskan di bawah.

Alur Pembaruan Akun

Alur pembaruan akun memungkinkan Integrator Pembayaran memberi tahu Google tentang pembaruan pada akun integrator pengguna. Kolom ini awalnya disediakan ke Google selama alur asosiasi. Beberapa contoh data akun yang mungkin ingin diperbarui oleh Integrator Pembayaran meliputi:

  • batas transaksi bulanan, harian, dan per item pengguna
  • status penyediaan akun integrator pengguna
  • jenis akun integrator pengguna (prabayar, pasca bayar, perusahaan, dll.)
  • 'accountAlias', 'accountUsername', atau 'fullAccountUsername'
  • apakah pengguna telah menyiapkan, menghapus, atau mengubah PIN statis yang dibagikan sebelumnya
  • apakah pengguna telah menutup akunnya atau mengubah nomor telepon -- membatalkan validasi instrumen pengguna di sistem Google.
  • hapus alur token

Perbandingan dengan Spesifikasi DCB3

Alur pembaruan akun menggantikan komponen spesifikasi DCB3 berikut:

  • Polling panggilan SOAP GetProvider
  • Pembatalan validasi token berkala

Alur Pembelian

Untuk ringkasan umum tentang alur pembelian FOP dengan Token, lihat halaman ini.

Detail Tagihan Operator

Beberapa operator menggunakan USSD atau teknologi lain untuk mengumpulkan PIN dari pengguna mereka selama setiap pembelian. Untuk operator ini, alih-alih memanggil capture(), kita memanggil asinkronCapture() dan memberi waktu 30 detik agar operator bisa meminta PIN pengguna dan menyelesaikan pengambilan. Saat status akhir pembayaran ditentukan, operator akan memberi tahu Google tentang hasilnya dengan memanggil captureResultNotification().

Perbandingan dengan Spesifikasi DCB3

Ada perubahan besar di sini.

  • Panggilan metode tunggal dan sinkron -- capture() bukan file auth() + batch
  • Tidak ada file batch sama sekali
  • Tidak ada metode cancel() (ambil + pengembalian dana, bukan auth + cancel)
  • Tidak ada kolom user_message sebagai respons -- kode penolakan dipetakan ke pesan milik Google yang dilokalkan ke bahasa akun pengguna.
  • Perubahan terminologi utama:
    • CorrelationId -> requestId
    • BillingApprovalId -> paymentIntegratorAccountId
    • OperatorUserToken -> googlePaymentToken

Alur Pembelian Tantangan

Pengembangan berkelanjutan untuk mendukung alur pembelian yang mencakup tantangan autentikasi kepada pengguna sebelum setiap pembelian. Sebagian besar metode autentikasi yang dapat digunakan sebelum alur pengaitan juga dapat digunakan sebelum alur pembelian yang menantang untuk memberikan autentikasi pengguna tambahan.

Alur Pengembalian Dana

Untuk ringkasan umum tentang alur pengembalian dana untuk FOP dengan Token, lihat halaman ini.

FOP dengan token mendukung alur pengembalian dana satu pesan. Metode pengembalian dana mendukung pengembalian dana penuh untuk pembelian atau pengembalian dana sebagian dari pembelian. Beberapa pengembalian dana sebagian dapat mengembalikan dana untuk satu pembelian.

Detail Tagihan Operator

Tidak ada hal yang khusus pada instrumen Tagihan Operator dalam alur pengembalian dana.

Perbandingan dengan Spesifikasi DCB3

Pengembalian dana dipicu oleh panggilan API sinkron, bukan file. Selain itu, beberapa pengembalian dana sebagian dapat dibuat untuk satu pembayaran awal, bukan hanya mendukung satu pengembalian dana dalam nilai penuh.

Alur Transfer Dana

Untuk mengetahui ringkasan umum tentang alur pembayaran FOP dengan Token, lihat halaman ini.

Alur pembayaran adalah cara Google dan Integrator Pembayaran melakukan penyelesaian. Google adalah sistem pencatatan yang mencatat transfer dana. Secara rutin, Google mengirimkan laporan transfer dana ke Integrator Pembayaran. Pernyataan tersebut memberikan ringkasan jumlah yang harus dibayar Integrator Pembayaran kepada Google beserta petunjuk cara membayar Google. Agar Integrator Pembayaran dapat direkonsiliasi, Integrator Pembayaran dapat mengkueri Google untuk mengetahui detail tingkat transaksi yang menyusun laporan pembayaran.

Detail Tagihan Operator

remittanceStatementDetails Tagihan Operator mencakup kolom tambahan yang belum tercantum dalam definisi API alur transfer dana. Di antaranya meliputi:

  • revshareCategory
  • itemPrice
  • tax
  • timestamp

Untuk operator dengan perjanjian pembagian keuntungan 50/50 dengan Google, biaya yang ada dalam remittanceStatementDetails diagregasi per revshareCategory, bukan ditampilkan per peristiwa.

Perbandingan dengan Spesifikasi DCB3

Alur pembayaran menggantikan konsep berikut di spesifikasi DCB3:

  • PDF LaporanTagihan Bulanan/LaporanPembayaran
  • File CSV detail invoice bulanan
  • File CSV pengintaian harian

Perbedaan utamanya adalah penghapusan file dan dukungan untuk transfer dana harian. Jumlah yang akan ditransfer dikirim melalui API sinkron, bukan file, dan API lain mendukung pembuatan kueri untuk mengetahui detail tentang laporan transfer dana.

Alur Pelaporan Penipuan

Dengan alur pelaporan penipuan, integrator pembayaran dapat memberi tahu Google tentang kemungkinan transaksi penipuan dengan memanggil metode fraudNotification. Alur ini digunakan untuk memperbarui mesin risiko internal Google dan tidak memulai pergerakan uang apa pun.

Detail Tagihan Operator

Tidak ada hal khusus terkait instrumen Tagihan Operator dalam alur notifikasi pembalikan pembayaran.