API: Payment methods

Ask the API what a method supports rather than hard-coding it.

These endpoints return the same catalogue the API validates against, so a currency listed here is a currency that will be accepted, and one that is not will be refused before a bank is called.

Every method and its rules

The full catalogue, whether or not your account is enabled for it.

Response

{
  "object": "list",
  "data": [
    {
      "method": "ideal",
      "display_name": "iDEAL",
      "currencies": ["EUR"],
      "countries": ["NL"],
      "refunds": { "kind": "standard", "withinDays": 180 },
      "supports_recurring": false,
      "requires_redirect": true,
      "async_settlement": false,
      "required_fields": ["country"],
      "chargebacks": false,
      "notes": null
    }
  ]
}

Enabled on your account

Only the methods you can actually create a payment with today. Drive your checkout from this rather than from a hard-coded list, and a newly enabled method appears without a deploy.

Response

{
  "object": "list",
  "data": [
    { "method": "ideal", "display_name": "iDEAL", "currencies": ["EUR"] },
    { "method": "bancontact", "display_name": "Bancontact", "currencies": ["EUR"] }
  ]
}

On every request

Errors follow one shape across every endpoint, described in errors.