Ringkasan

Setiap metode dikenali dari kodenya — qris, va_bca, card. String itulah yang Anda kirim dan yang Anda terima kembali. Semua metode yang aktif bisa dipakai 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 biaya flat rupiah, mis. {"percent_bps": 70, "flat": 250} untuk QRIS. Ambil dari endpoint ini, jangan hard-code kode atau tarifnya — 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. Data yang dibutuhkan metode baru diperlukan saat pembayaran — jadi Anda yang mengirimnya di customer, atau halaman checkout yang menanyakannya ke pembeli.

Di Direct API tidak ada halaman yang bisa menanyakan data, jadi create dengan metode yang field wajibnya kosong ditolak 422 beserta nama field-nya. Di Checkout, langkah customer yang mengumpulkan data yang kurang — jadi baru jadi error kalau Anda juga membuang langkah itu dari checkout.steps.

Memilih metode yang ditawarkan

Create menerima payment_methods — array berisi kode metode yang boleh dipakai untuk pembayaran ini. Field ini mempersempit pilihan pembeli; tidak pernah bisa melebihi metode yang sudah aktif di akun Anda.

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

• Tidak dikirim — semua metode yang aktif di akun Anda ditawarkan.
• Satu kode — metode itu saja, tanpa pilihan metode. Direct API langsung menerima object payment-nya.
• Beberapa kode — pembeli memilih dari kode-kode itu, sesuai urutan yang Anda kirim.

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