> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quidkey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Schemes

> The payment scheme codes a country and a bank account carry, and what each means

A payment scheme is the network a bank payment travels on. Its code appears in two places:

* `country.payment_schemes`, from `GET /countries/{id}`: the schemes active in the country, the default first, which is what a bank account there can take.
* `bank_account.payment_schemes`, and the `payment_schemes` you can send when you create a bank account: which schemes Quidkey offers for a payment transaction routed to that account.

Each entry is a link with no `_link`, because schemes aren't a resource you can fetch: `{ "_type": "payment_scheme", "id": "faster_payments", "is_default": true }`. Codes are stable, and new ones can appear, so handle a code you don't recognise.

| Code | Scheme |
| - | - |
| `sepa_instant_credit_transfer` | SEPA Instant Credit Transfer, the euro area's instant bank transfer |
| `sepa_credit_transfer` | SEPA Credit Transfer, the euro area's standard bank transfer |
| `faster_payments` | Faster Payments, the UK's instant bank transfer |
| `bacs` | Bacs, the UK's batch bank transfer |
| `danish_domestic_credit_transfer` | Danish domestic credit transfer |
| `multibanco` | Multibanco, Portugal's payment reference network, an additional payment method |
| `ach` | ACH, the US bank transfer network |
| `becs` | BECS, Australia's bulk electronic clearing system |

`GET /countries/{id}` says which schemes a country offers, and which is its default:

```bash theme={null}
curl 'https://api.quidkey.com/v1/countries/GB' \
  -H 'Authorization: Bearer ACCESS_TOKEN'
```

```json theme={null}
"payment_schemes": [
  { "_type": "payment_scheme", "id": "faster_payments", "is_default": true }
]
```

## Schemes on a Bank Account

When you create a bank account, leave `payment_schemes` out and the country's schemes are attached, all active. An additional payment method, such as `multibanco`, is attached only when you name it:

```json theme={null}
"payment_schemes": [
  { "id": "sepa_instant_credit_transfer", "is_active": true },
  { "id": "sepa_credit_transfer", "is_active": true },
  { "id": "multibanco", "is_active": true }
]
```

A scheme the account's country doesn't offer answers 400 `SCHEME_NOT_AVAILABLE_IN_COUNTRY`, and the same scheme twice answers 400 `DUPLICATE_PAYMENT_SCHEMES`. An account's schemes can't change after it's created. `is_active` says whether Quidkey offers that scheme for a payment transaction routed to the account. It has no part in how a payout reaches the account.

The identifiers an account needs depend on its country, not on its schemes. See [Bank account identifiers](https://docs.quidkey.com/api-v1/reference/bank-account-identifiers.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.