Ringkasan

Sebuah metode dikenali dari kodenya — qris, va_bca, card. Itulah string yang Anda kirim dan yang Anda terima kembali. Semua metode yang aktif berjalan lewat Direct API maupun Kasera Pay Checkout.

GET /v1/payment_methods mengembalikan daftar ini sesuai akun Anda, lengkap dengan rentang nominal, data pembeli yang dibutuhkan tiap metode, dan fee tiap metode — persen dalam basis poin plus nominal tetap rupiah, mis. {"percent_bps": 70, "flat": 250} untuk QRIS. Baca daftarnya, jangan tulis kode atau tarifnya permanen di kode Anda — sebuah metode bisa diaktifkan, dihentikan, atau diubah tarifnya tanpa rilis di sisi Anda.

Data pembeli yang dibutuhkan tiap metode

Tidak ada data pembeli yang wajib saat create. Yang dibutuhkan sebuah metode, dibutuhkan saat pembayaran — jadi Anda yang mengirimnya di customer, atau halaman checkout yang menanyakannya ke pembeli.

Pada Direct API tidak ada halaman yang bisa bertanya, jadi create yang menyebut metode dengan field wajib yang kosong ditolak 422 beserta nama fieldnya. Pada Checkout langkah customer yang mengumpulkan kekurangannya — jadi itu baru menjadi error kalau Anda juga menghilangkan langkah itu dari checkout.steps.

Memilih metode yang ditawarkan

Sebuah create menerima payment_methods — array berisi kode, yaitu metode yang boleh dipakai untuk pembayaran ini. Isian itu mempersempit pilihan pembeli; tidak pernah bisa melebihi apa yang sudah diaktifkan di akun Anda.

{
  "amount": 150000,
  "external_id": "ORD-1234",
  "payment_methods": ["va_bca", "va_bri", "qris"]
}

• Dikosongkan — semua metode yang aktif di akun Anda ditawarkan.
• Satu kode — metode itu saja, tanpa pemilih. Direct API langsung menerima objek payment-nya.
• Beberapa kode — pemilih berisi kode-kode itu, sesuai urutan yang Anda kirim.

Responsnya melaporkan hasilnya dalam bentuk tunggal: payment_method adalah satu kode, tidak pernah null — diisi saat create dengan kode pertama yang Anda tawarkan, lalu diperbarui ke kode yang benar-benar dipilih pembeli.