Terminal-2 icon

Request payment methods

Learn how you can request new payment methods for your Terminal API integration.

Our payment terminals provide out-of-the-box support for the major global credit and debit cards. To accept additional payment methods, you need to request those payment methods in your Customer Area.

Requirements

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

Requirement Description
Integration type You must have a 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 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.

Request payment methods

You can request payment methods to be added to your merchant account in your test Customer Area or live Customer Area.

  1. In your Customer Area, switch to your merchant account.
  2. Go to Settings > 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 method(s) you want to request for .
  6. Select Add.
  7. If prompted, fill in the required information.
  8. Review your requests.
  9. 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.

After you add a payment method, the changes take effect when a payment terminal updates its configuration during the next maintenance call. To use the payment method immediately, you can update the configuration manually.

See also