Marketpay icon

Payment methods for marketplaces

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

Configure payment methods

To add a payment method to your merchant account, 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-
Required if you use business lines
The unique identifier of your user's business line for which you want to request a payment method.
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 to accept 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.
Afterpay afterpaytouch Requires additional parameters. Send separate requests for each currency.
Available currencies: AUD, CAD, EUR, GBP, NZD, USD.
Alipay alipay Requires shopper interaction.
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 MoR : Only ecommerce sales. Partner model is available for ecommerce and IPP as long as the store is located in France. Requires additional parameters.
China UnionPay (CUP) cup Requires shopper interaction.
Clearpay clearpay Requires additional parameters. Send separate requests for each currency.
Only available for GBP.
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
Google Pay googlepay Requires additional parameters.
iDEAL ideal
Interac interac_card
JCB jcb Requires shopper interaction for Australia, Canada, and New Zealand.
Klarna klarna Requires additional parameters.
klarna_account Requires additional parameters.
klarna_paynow Requires additional parameters.
Maestro maestro
MB WAY mbway
Mastercard mc
MobilePay mobilepay
Multibanco multibanco
Online banking Finland ebanking_fi
Online banking Poland onlinebanking_Pl
Open banking paybybank Available currencies: EUR and GBP.
PayPal paypal Requires additional configuration.
Payshop payshop
Trustly trustly
TWINT twint Requires additional parameters.
twint_pos Requires additional parameters.
Vipps vipps Requires additional parameters.
Visa visa
VPay vpay
WeChat Pay wechatpay Requires additional parameters.
wechatpay_pos Requires additional parameters.