Payment methods

List payment methods

The methods your account can accept right now, with what each one needs and costs.

GET/v1/payment_methods

Response fields

dataarrayoptional

Every method this key's account and mode can accept, in the order a buyer should be offered them. Not paged and no has_more: a catalogue is read whole. A method you or Kasera have switched off is absent, not flagged — which is why this list beats a hard-coded one.

data[].codestringoptional

The code to send in payment_methods, and what payment_method reports back: qris, va_bca … va_maybank, card.

Example: va_bca

data[].display_namestringoptional

The label to show a buyer, as-is.

Example: BCA Virtual Account

data[].typestringoptional

The payment.type a payment on this method will carry — qr, payment_code or redirect — so you can write the branch before you have seen one. See Payment methods.

Example: payment_code

data[].min_amount, data[].max_amountintegeroptional

The amount bounds a create naming this method is checked against, in whole rupiah. Outside them is 422 amount_too_small or amount_too_large.

data[].required_customer_fieldsarrayoptional

The customer.* paths this method cannot be fulfilled without — the same dotted paths a 422 customer_required names in error.fields. Always an array, [] when nothing is needed.

Example: ["customer.name"]

data[].feeobjectoptional

What a payment on this method costs you: percent_bps is a percentage of the amount in basis points (70 = 0.7%), flat is whole rupiah added on top, and label is the two rendered for humans — show it unmodified. This is your account's own rate when one has been negotiated; the sample shows the defaults.

Example: { "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" }
    }
  ]
}