Adyen-for-platform icon

Manage payment methods in Customer Area

Request and manage payment methods in your Customer Area.

During the onboarding process, you add payment methods to your users' stores. After we enable a payment method, your users can accept all of its payment method variants by default. For example, if you configure visa, they can also accept visadebit, visapremiumcredit, and visasignature.

This page explains how you can:

  • Request additional payment methods.
  • View all payment methods configured for your merchant account or store.
  • View the details of a specific payment method.
  • Update the countries or regions and currencies where your users can accept a payment method.
  • Enable or disable a payment method for your user.

Requirements

Before you begin, take into account the following requirements, limitations, and preparations.

Requirement Description
Integration type You must have an online or point of sale integration with Adyen.
Customer Area roles Make sure that you have the following role:
  • Change payment methods
Webhooks Subscribe to the following webhooks:
  • Payment method webhook
Limitations
  • You can only configure and use payment methods that are supported for your currency and integration.
  • Some payment methods, like SEPA Direct Debit, may only be available through the Management API. For more details, refer to each payment method description.
  • Some platform setups cannot request payment methods in the live Customer Area. If Request payment methods is not available in your live Customer Area, use the Management API to add payment methods to your users' stores.
  • If the account holder’s receivePayments capability is not allowed, they cannot use the requested payment method.
  • It may take some time for the payment method to become available due to external factors. Payment methods typically appear within a day. To avoid delays, we recommend requesting payment methods at least one day before the business opens.
  • The currency of payment methods is set by default and depends on the specific payment method type. If your implementation is different and you need to change the currency, contact our Support Team.
Setup steps Before adding a payment method in the Customer Area, make sure that both the business line and the store are already created.

Request payment methods

Some platform setups cannot request payment methods in the live Customer Area. If Request payment methods is not available in your live Customer Area, use the Management API to add payment methods to your users' stores.

You can submit a request to add payment methods to your user's store in your Customer Area.

  1. In your Customer Area, switch to your merchant account.
  2. Go to Payments > Payment methods.
  3. Select Request payment methods to view all available payment methods.
  4. Use the dropdown lists to filter payment methods by location and type.
  5. Select the payment methods you want to add to your user's store.
  6. Select Add.
  1. Apply the payment methods to your user's Store.
  1. If prompted, fill in the required information.
  2. Review your requests.
  3. Select Submit request.

Webhooks

Because adding a payment method to your user's store is an asynchronous process, we recommend that you subscribe to the Management webhooks in your Customer Area.

After the payment method has been added to your store, Adyen sends a paymentMethod.created webhook.

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

Troubleshooting

If you see an error message immediately after selecting Submit request, review and correct the information before resubmitting.

In rare cases, something may go wrong after submission, and the request does not go through. If you are not subscribed to webhooks, you will not receive an automated failure alert. If this happens, you must wait 24 hours before trying again.

Account holder status

By default, every payment method that you ask for is enabled for your user. However, a requested payment method stays pending, and your user cannot use it, until the account holder's receivePayments capability has the following values:

Parameter Description Value
verificationStatus The status of the verification checks for the capability. valid
enabled Indicates whether the capability is enabled. true
allowed Indicates whether the capability is allowed. Adyen sets this to true if the verification is successful and the account holder is permitted to use the capability. true

While a payment method is pending, it does not appear in the payment methods overview, and you cannot activate or deactivate it.

The receivePayments capability is usually not allowed because verification data or documents are missing or invalid. This can affect the account holder's legal entity, its entity associations (for example owners or directors), or its transfer instruments.

If you update your user's legal entity or account holder information after it has been verified, the payment methods can be disabled until the account holder is verified again.

To check the status of your account holder's receivePayments capability, you can either send a GET /accountHolders/{id} request, or listen to the balancePlatform.accountHolder.updated webhook.

To resolve a pending payment method:

  1. Find the account holder's receivePayments capability, either in your Customer Area or with the request and webhook shown in the tabs.
  2. Check whether the capability is enabled. If enabled is false, enable the capability.
  3. Check the verification status of the capability:
  4. Provide valid data or documents for the legal entity, its entity associations, or its transfer instruments. If your user is a sub-merchant that you onboard, ask them to supply valid details.

After Adyen reviews the information and the capability is enabled, allowed, and valid, Adyen adds the pending payment methods to the store automatically. You do not need to ask for them again.

If the capability's verification status is rejected , updating data or documents does not change the status.

View payment methods

  1. In your Customer Area, switch to your merchant account.
  2. Go to Payments > Payment methods.
    All payment methods configured for your merchant account are listed in the dynamic table.
  3. You can choose which payment methods to display by using filters and configuring table columns.
  4. To view all the details of a specific payment method, select its name in the overview table.
    A side panel opens, displaying all its details.

Activate or deactivate payment methods

  1. In your Customer Area, switch to your merchant account.
  2. Go to Payments > Payment methods.
  3. Select the checkbox next to the payment method(s) whose status you want to change.
  4. Select More actions, then choose Activate or Deactivate.

If you deactivate a payment method and this remains in the Inactive state and unused for 90 days, the payment method is automatically deleted. Payment methods linked to a closed store are automatically set to Inactive and deleted after 90 days.

If you deactivate a payment method, it is not deleted from your merchant account right away. To delete it permanently before the automatic deletion, contact our Support Team.

Diners Club International® is part of Discover. These payment methods are always bundled, and you cannot selectively activate or deactivate one and not the other.

Change payment method country/region settings

  1. In your Customer Area, switch to your merchant account.
  2. Go to Payments > Payment methods.
  3. Select the payment method(s) you want to update.
  4. To change the country or region where you want the payment method(s) to be available, select Edit > Country/Region.
    1. Select the new country or region from the dropdown list.
    2. Choose ANY if you don't want to place any restrictions on its availability.

See also