Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Payment methods for platforms

Learn which payment methods you can support in your platform, and how to configure them.

Configure payment methods

Payment methods must be configured separately for each of your users' stores. If you do not configure payment methods for a store, payments will be processed at your merchant account level instead.

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 -white_check_mark- The payment method variant. Some payment methods require additional configuration or parameters. For details, see the Supported payment methods.
businessLineId -white_check_mark- The unique identifier of your user's business line for which you want to request a payment method.
storeId -white_check_mark- The id of the store that you get when creating a store for your user.
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's an example of a request to add 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'll receive a paymentMethod.created webhook.

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

Supported payment methods

Payment method Payment method variant Notes
ACH Direct Debit ach Requires approval, reach out to your Adyen contact.
American Express amex Requires currencies and shopper interaction.
Apple Pay applepay Requires additional parameters for ecommerce. For in-person payments, there is no need to configure Apple Pay.
Bancontact bcmc Requires additional parameters.
BLIK blik
Carte Bancaire cartebancaire Only supported for the ecommerce sales channel. Requires additional parameters.
China UnionPay (CUP) cup Requires shopper interaction.
Diners diners Discover will be automatically included in the setup. Diners Club International® is part of Discover.
Discover discover Diners will be automatically included in the setup. Diners Club International® is part of Discover.
eftpos Australia eftpos_australia
girocard girocard
giropay giropay Requires additional parameters.
Google Pay googlepay Requires additional parameters.
iDEAL ideal
Interac interac_card
JCB jcb Requires shopper interaction for Australia, Canada, and New Zealand.
Maestro maestro
Mastercard mc
MobilePay mobilepay
Multibanco multibanco
Online banking Poland onlinebanking_Pl
Open banking paybybank Available currencies: GBP.
Sofort directEbanking Requires additional parameters.
Trustly trustly
TWINT twint Requires additional parameters.
twint_pos Requires additional parameters.
Vipps vipps Requires additional parameters.
Visa visa
VPay vpay