You can request the payment methods your user can accept in your Customer Area. After we receive the request, we will contact you if there are additional requirements before we can add it to your account.
Requirements
Before you begin, take into account the following requirements, limitations, and preparations.
| Requirement | Description | |
|---|---|---|
| Integration type | You must have an online payments integration and a checkout UI with Adyen. | |
| Customer Area roles | Make sure that you have the following role:
|
|
| Webhooks | Subscribe to the following webhooks:
|
|
| Limitations |
|
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 merchant account.
- Select Add.
- Apply the payment method(s) to This merchant account.
- 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.