Transaksi yang Dimulai Penjual (MIT)

Ringkasan Dukungan MIT

Transaksi yang Dimulai Penjual (MIT) adalah transaksi yang diproses tanpa pengguna sedang aktif dalam sesi. Pembaruan pada Google Pay Online API ini memberikan visibilitas yang lebih baik untuk jenis transaksi ini, pengalaman pengguna yang lebih baik melalui UX detail penagihan khusus, dan kontinuitas pembayaran yang lebih baik.

Kasus Penggunaan Utama

  • Pembayaran Berulang: Layanan streaming digital, langganan, atau utilitas.
  • Pembayaran Tertunda: Reservasi hotel, praorder, atau biaya ketidakhadiran.
  • Isi Ulang Otomatis: Isi ulang saldo untuk kartu voucher atau kartu transportasi umum.

Implementasi MIT API

MIT API adalah ekstensi dari loadPaymentData API yang ada. Integrator harus menyertakan tepat satu objek *TransactionInfo untuk menentukan niat penagihan. Google menyediakan 3 opsi, bergantung pada jenis Transaksi yang Diprakarsai Penjual (MIT):

Jenis Transaksi Nama Objek Deskripsi
Berulang RecurringTransactionInfo Digunakan untuk biaya frekuensi tetap. Mendukung penagihan uji coba, prabayar, dan pascabayar.
Ditangguhkan DeferredTransactionInfo Digunakan untuk satu kali penagihan pada waktu mendatang yang telah ditentukan.
Isi Ulang Otomatis AutomaticReloadTransactionInfo Digunakan untuk mengisi ulang akun nilai tersimpan saat saldo berada di bawah nilai minimum.

Langkah-Langkah Integrasi

  1. Dokumentasi: Akses DevSite selama Program Akses Awal. Tiga definisi objek baru berada di bagian Referensi Objek, dan ditautkan langsung dalam daftar sebelumnya.
  2. Implementasi: Gunakan objek *TransactionInfo yang relevan untuk sistem Anda dalam permintaan API.
    • Perhatikan bahwa hanya satu objek yang dapat diteruskan per permintaan ke API. Penentuan objek yang akan digunakan dan pengisian kolom diserahkan kepada masing-masing penjual.
  3. Pengujian: Gunakan lingkungan TEST untuk memvalidasi bahwa detail penagihan dirender dengan benar di lembar pembayaran.
  4. Peluncuran: Mulai live setelah parameter diverifikasi.

Pengelolaan Siklus Proses Token (TLM)

Pengelolaan Siklus Proses Token memastikan kelangsungan pembayaran dengan memberikan notifikasi real-time saat token pembayaran yang aman diperbarui atau dinonaktifkan. Untuk mengetahui detail selengkapnya, lihat dokumentasi Pengelolaan Siklus Proses Token .

Peristiwa Token Utama

  • Penonaktifan/Penghapusan: Memberi tahu saat token tidak dapat digunakan lagi.
  • Pembaruan Suffix FPAN: Terjadi saat Nomor Rekening Utama Pendanaan yang mendasarinya diperbarui.

Persyaratan Penyiapan Server

Penjual Langsung dan Penyedia Layanan Pembayaran (PSP) harus membuat sistem untuk menerima, mendekripsi, dan memproses pesan ini.

Persyaratan Deskripsi
Endpoint Endpoint HTTPS yang aman untuk menerima panggilan POST.
Autentikasi Harus menangani validasi tanda tangan dan dekripsi pesan.
Respons Menampilkan SUCCESS untuk melanjutkan notifikasi, atau TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE untuk menghentikannya.
Notifikasi Penjual PSP harus menginformasikan status token kepada penjual mereka.

Catatan Penerapan

Endpoint tokenUpdateUrl harus diteruskan dengan transaksi untuk menerima update token. Untuk PSP, penentuan cara penjual akan menerima dan mengisi URL ini dalam objek *TransactionInfo yang relevan adalah tanggung jawab PSP untuk ditentukan.

Perhatikan juga bahwa payload terenkripsi akan menampilkan kolom opsional tambahan, merchantTokenId, untuk MIT. Untuk mengetahui detail spesifik, lihat dokumentasi Kriptografi Data Pembayaran (untuk Penjual) atau dokumentasi Struktur Payload (untuk PSP).