Payment methods

Before you 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.

Payment methods must be configured separately for each of your users' stores.

Before you begin

Make sure that:

• The payment method you want to configure is supported.
• Your Management API credential has the Management API—Payment methods read and write role.

Configure payment methods for a store

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.
storeIds		The id of the store that you get when creating a store for your user. For the list of stores in your merchant account, make a GET /merchants/{merchantId}/stores request.
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 is an example of a request to accept 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 receive a paymentMethod.created webhook.

Here's an example of the webhook you receive after adding Visa to your payment methods:

Payment method status

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.

Supported payment methods

¹ This payment method does not support aggregated acquiring accounts for payment facilitators. This means that you must create business lines and stores in your merchant account for the users that want to accept it.