Payment methods

List the payment methods configured for this client. Use the returned paymentMethodId in the Cart checkout call.

List payment methods

GET /v1/:client_name/peppered/paymentmethods

Response

200 OK — array of PaymentMethodResource:

[
  { "paymentMethodId": 1, "name": "iDEAL",   "fee": 0.00 },
  { "paymentMethodId": 2, "name": "Cash",    "fee": 0.00 },
  { "paymentMethodId": 3, "name": "Invoice", "fee": 2.50 }
]

PaymentMethodResource fields

Field	Type	Description
paymentMethodId	integer	Unique ID — use in cart checkout
name	string	Display label (from the client's handling_text_payment configuration)
fee	decimal	Transaction fee (fixed amount)

Label origin

Labels are per-client. Every organisation configures their own labels in the Dashboard (Systeem → Betaalmethoden). One client might see iDEAL, another might call the same method Online banking. Always use the paymentMethodId for programmatic references.

---

See also: Cart checkout · Betaalmethoden (Dashboard, NL)