Metode pembayaran

Daftar metode pembayaran

Metode yang bisa diterima akun Anda saat ini, beserta syarat dan tarif masing-masing.

GET/v1/payment_methods

Field response

dataarrayopsional

Semua metode yang bisa diterima akun dan mode key ini, dalam urutan yang sebaiknya ditawarkan ke pembeli. Tanpa paging dan tanpa has_more: katalognya dibaca utuh. Metode yang Anda atau Kasera matikan tidak muncul sama sekali, bukan ditandai — makanya daftar ini lebih baik daripada daftar yang di-hard-code.

data[].codestringopsional

Kode yang dikirim di payment_methods, dan yang dilaporkan kembali di payment_method: qris, va_bca … va_maybank, card.

Contoh: va_bca

data[].display_namestringopsional

Label untuk ditampilkan ke pembeli, apa adanya.

Contoh: BCA Virtual Account

data[].typestringopsional

payment.type yang akan dibawa pembayaran dengan metode ini — qr, payment_code, atau redirect — supaya Anda bisa menulis percabangannya sebelum pernah melihat satu pun. Lihat Metode pembayaran.

Contoh: payment_code

data[].min_amount, data[].max_amountintegeropsional

Batas amount yang diperiksa pada create yang menyebut metode ini, dalam rupiah utuh, untuk akun Anda — tiap metode punya batasnya sendiri. Di luarnya ditolak 422 amount_too_small atau amount_too_large. Checkout yang menawarkan beberapa metode hanya menawarkan metode yang cocok dengan amount-nya.

data[].required_customer_fieldsarrayopsional

Path customer.* yang wajib ada supaya metode ini bisa dipakai — dotted path yang sama dengan yang disebut 422 customer_required di error.fields. Selalu array, [] kalau tidak butuh apa-apa.

Contoh: ["customer.name"]

data[].feeobjectopsional

Biaya pembayaran dengan metode ini untuk Anda: percent_bps adalah persentase dari amount dalam basis poin (70 = 0,7%), flat adalah rupiah utuh yang ditambahkan, dan label adalah keduanya dalam format yang mudah dibaca — tampilkan apa adanya. Kalau tarif akun Anda sudah dinegosiasikan, yang tampil tarif itu; contoh di sini pakai tarif default.

Contoh: { "percent_bps": 70, "flat": 250, "label": "0.7% + Rp250" }

GET /v1/payment_methods
curl https://pay.kasera.id/v1/payment_methods \
  -H "Authorization: Bearer kp_live_..."
{
  "data": [
    {
      "code": "qris",
      "display_name": "QRIS",
      "type": "qr",
      "min_amount": 10000,
      "max_amount": 10000000,
      "required_customer_fields": [],
      "fee": { "percent_bps": 70, "flat": 250, "label": "0.7% + Rp250" }
    },
    {
      "code": "va_bca",
      "display_name": "BCA Virtual Account",
      "type": "payment_code",
      "min_amount": 10000,
      "max_amount": 10000000,
      "required_customer_fields": ["customer.name"],
      "fee": { "percent_bps": 0, "flat": 5000, "label": "Rp5.000" }
    },
    {
      "code": "card",
      "display_name": "Credit Card",
      "type": "redirect",
      "min_amount": 10000,
      "max_amount": 10000000,
      "required_customer_fields": ["customer.email"],
      "fee": { "percent_bps": 280, "flat": 2500, "label": "2.8% + Rp2.500" }
    }
  ]
}