Configure payment methods
To add a payment method to your merchant account, 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 | Required if you use business lines |
The unique identifier of your user's business line for which you want to request a payment method. |
| 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 to accept 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. |
| Afterpay | afterpaytouch | Requires additional parameters. Send separate requests for each currency. Available currencies: AUD, CAD, EUR, GBP, NZD, USD. |
| Alipay | alipay | Requires shopper interaction. |
| 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. |
| Clearpay | clearpay | Requires additional parameters. Send separate requests for each currency. Only available for GBP. |
| 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 | |
| Google Pay | googlepay | Requires additional parameters. |
| iDEAL | ideal | |
| Interac | interac_card | |
| JCB | jcb | Requires shopper interaction for Australia, Canada, and New Zealand. |
| Klarna | klarna | Requires additional parameters. |
| klarna_account | Requires additional parameters. | |
| klarna_paynow | Requires additional parameters. | |
| Maestro | maestro | |
| MB WAY | mbway | |
| Mastercard | mc | |
| MobilePay | mobilepay | |
| Multibanco | multibanco | |
| Online banking Finland | ebanking_fi | |
| Online banking Poland | onlinebanking_Pl | |
| Open banking | paybybank | Available currencies: EUR and GBP. |
| PayPal | paypal | Requires additional configuration. |
| Payshop | payshop | |
| Trustly | trustly | |
| TWINT | twint | Requires additional parameters. |
| twint_pos | Requires additional parameters. | |
| Vipps | vipps | Requires additional parameters. |
| Visa | visa | |
| VPay | vpay | |
| WeChat Pay | wechatpay | |
| wechatpay_pos | ||