Before you can start processing payments for your users, you must configure the payment methods through which they can accept payments. Adyen's payment platform supports most global and local card payment methods with a single technical integration.
Before you begin
Make sure that:
- The payment method you want to configure is supported.
- Your Customer Area user has the Change payment methods role.
- Your Management API credential has the Management API—Payment methods read and write role.
Request payment methods for a merchant account
To add a payment method to your merchant account:
- Log in to your Customer Area.
- Switch to your merchant account.
- Go to Settings > Payment methods.
- Select Request payment methods.
- Start entering the name of the payment method, then select it from the drop-down list.
- Select Submit.
Adyen will contact you if there are additional requirements before we can add the payment method to your account.
Update a payment method
To update the settings of a payment method, make a PATCH /merchants/{merchantId}/paymentMethodSettings/{paymentMethodId} request with your merchant account in the path. In the body, specify:
| Parameter | Required | Description |
|---|---|---|
| countries | The list of countries to enable with the payment method. If sent empty, then all countries are supported by the payment method. | |
| currencies | The list of currencies to enable with the payment method. If sent empty, then all currencies are supported by the payment method. | |
| enabled | Indicates whether the payment method is enabled (true) or disabled (false). |
Here's an example of requesting to update Visa payment method by adding support for cards issued in the United States:
The response contains the id of the requested payment method and the updated list of payment method settings.
Get payment method details
You can get the details of a single payment method available on the merchant account or all payment methods available on the merchant account, store, and business line.
Get the details of a specific payment method
To get the details of a single payment method available on the merchant account, make a GET /merchants/{merchantId}/paymentMethodSettings/{paymentMethodId} request with your merchant account and the payment method ID in the path.
Get the details of all payment methods
To get the details of all payment methods available on the merchant account, make a GET /merchants/{merchantId}/paymentMethodSettings request with your merchant account in the path.
You can filter the response using the following query parameters:
- storeIds: The unique identifier of the store for which to return the payment methods.
- businessLineId: The unique identifier of the business line for which to return the payment methods.