During the onboarding process, you already added payment methods to your users' stores. After we enable a payment method, your users can start accepting all of the payment method's variants by default. For example, if you configure visa, they can accept all of its variants, including visadebit, visapremiumcredit, visasignature and so on.
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 country/region and currency of 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:
|
|
| Webhooks | Subscribe to the following webhooks:
|
|
| Limitations |
|
|
| 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
You can request payment methods to be added to your merchant account in your test Customer Area or live Customer Area.
- In your Customer Area, switch to your merchant account.
- Go to Settings > Payment methods.
- Select Request payment methods to view all available payment methods.
- Use the dropdown lists to filter payment methods by location and type.
- Select the payment method(s) you want to request for your user's store.
- Select Add.
- Apply the payment method your user's Store.
- If prompted, fill in the required information.
- Review your requests.
- Select Submit request.
To see how to add payment methods, you can also watch a video here:
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 you request is enabled for your user. However, only verified account holders can use the configured payment methods. This means that the account holder must have the following parameters and values set for the receivePayments capability:
| 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 |
If you update you user's legal entity or account holder information after it has been verified, the payment methods may 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.
View payment methods
- In your Customer Area, switch to your merchant account.
- Go to Settings > Payment methods.
All payment methods configured for your merchant account are listed in the dynamic table. - You can choose which payment methods to display by using filters and configuring table columns.
- 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
- In your Customer Area, switch to your merchant account.
- Go to Settings > Payment methods.
- Select the checkbox next to the payment method(s) whose status you want to change.
- Select More actions, then choose Activate or Deactivate.
Payment methods set to Inactive and unused for 90 days are automatically deleted. Payment methods linked to a closed store are automatically set to Inactive and deleted after 90 days.
Change payment method settings
- In your Customer Area, switch to your merchant account.
- Go to Settings > Payment methods.
- Select the payment method(s) you want to update.
- To change the country or region where you want the payment method(s) to be available, select Edit > Country/Region.
- Select the new country or region from the dropdown list.
- Choose ANY if you don't want to place any restrictions on its availability.
- To change the accepted currency of the payment method, select Edit > Currency.
- Select the new currency (or currencies) from the dropdown list.
- Choose ANY if you don't want to place any restrictions on its accepted currencies.