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 | |