Configure payment methods
Payment methods must be configured separately for each of your users' stores. If you do not configure payment methods for a store, payments will be processed at your merchant account level instead.
To add a payment method to your user's store, make a POST /merchants/{merchantId}/paymentMethodSettings request, specifying the following parameters:
| Parameter | Required | Description |
|---|---|---|
| type |  |
The payment method variant. Some payment methods require additional configuration or parameters. For details, see the Supported payment methods. |
| businessLineId | |
The unique identifier of your user's business line for which you want to request a payment method. |
| storeId | |
The id of the store that you get when creating a store for your user. |
| countries | The list of countries to enable with the payment method. To enable all countries supported by the payment method, set to ANY or send empty. | |
| currencies | The list of currencies to enable with the payment method. To enable all currencies supported by the payment method, set to ANY or send empty. |
Here's an example of a request to add Visa payments from cards issued in the Netherlands:
The response contains the id of the requested payment method.
Webhooks
After the payment method has been added to your store, you'll receive a paymentMethod.created webhook.
Here's an example of the webhook you receive after adding Visa to your payment methods:
Supported payment methods
| Payment method | Payment method variant | Notes |
|---|---|---|
| ACH Direct Debit | ach | Requires approval, reach out to your Adyen contact. |
| American Express | amex | Requires currencies and shopper interaction. |
| Apple Pay | applepay | Requires additional parameters for ecommerce. For in-person payments, there is no need to configure Apple Pay. |
| Bancontact | bcmc | Requires additional parameters. |
| BLIK | blik | |
| Carte Bancaire | cartebancaire | Only supported for the ecommerce sales channel. Requires additional parameters. |
| China UnionPay (CUP) | cup | Requires shopper interaction. |
| Diners | diners | Discover will be automatically included in the setup. Diners Club International® is part of Discover. |
| Discover | discover | Diners will be automatically included in the setup. Diners Club International® is part of Discover. |
| eftpos Australia | eftpos_australia | |
| girocard | girocard | |
| giropay | giropay | Requires additional parameters. |
| Google Pay | googlepay | Requires additional parameters. |
| iDEAL | ideal | |
| Interac | interac_card | |
| JCB | jcb | Requires shopper interaction for Australia, Canada, and New Zealand. |
| Maestro | maestro | |
| Mastercard | mc | |
| MobilePay | mobilepay | |
| Multibanco | multibanco | |
| Online banking Poland | onlinebanking_Pl | |
| Open banking | paybybank | Available currencies: GBP. |
| Sofort | directEbanking | Requires additional parameters. |
| Trustly | trustly | |
| TWINT | twint | Requires additional parameters. |
| twint_pos | Requires additional parameters. | |
| Vipps | vipps | Requires additional parameters. |
| Visa | visa | |
| VPay | vpay | |