Default icon

Payment method setup

Set up payment methods for your integration.

View source

The standard Adyen integration supports a wide range of payment methods, including the following:

  • Credit cards: Visa, Mastercard, American Express, Discover, Diners Club, JCB, UnionPay, and all major credit cards.
  • Debit cards: Visa Debit, Mastercard Debit, Maestro, and more.
  • Digital wallets: Apple Pay, Google Pay, PayPal, WeChat Pay, Alipay, and more.
  • Buy now, pay later: Klarna, Afterpay, Affirm, and many more.
  • Bank transfers: iDEAL, Sofort, Bancontact, Giropay, EPS, and many more.
  • Real-time payments: PIX, SEPA Instant, and many more.
  • Vouchers, prepaid, and gift cards: Many different providers.

We recommend that you integrate payment methods that are popular for shoppers in your target markets. You can use most of the payment methods that we offer without any additional setup. However, some payment methods require additional setup before you can use them:

Apple Pay

To use Apple Pay:

  1. Set up your server to allow Apple Pay IP addresses.

  2. Set up an Apple Pay certificate. You can use Adyen's certificate or your own certificate.

    You can use Adyen's Apple Pay certificate to process Apple Pay payments. This means that you do not have to use your own certificate. The benefits of using Adyen's Apple Pay certificate are:

    • A faster way to add Apple Pay to your integration.
    • There is less configuration required.

    To set up Apple Pay with Adyen's certificate:

    1. Set up your server for secure communication with Apple Pay.
      • All pages that include Apple Pay must be served over HTTPS.
      • Your domain must have a valid SSL certificate.
    2. Add Apple Pay in your Customer Area. You need to provide your:
      • Merchant name: the merchant account for which you want to set up Apple Pay.
      • Shop websites: your website URLs, for example https://www.mystore.com. If you add more than one, separate them with a comma. You cannot use http://localhost to test.

    Using your own Apple Pay certificate requires extra configuration steps.

    Before you begin, make sure that you have an Apple Developer account that is associated with either the Apple Developer Program, or the Apple Developer Enterprise Program.

    Create merchant identifiers

    A merchant identifier uniquely identifies you as a merchant who is able to accept Apple Pay payments. You can use the same merchant identifier for multiple websites.

    1. Log in to your Apple Developer account at https://developer.apple.com.
    2. Follow the Apple Developer Account Help instructions to create a merchant identifier. Your merchant identifier must include the prefix merchant.. We recommend using the prefix merchant.com.adyen. For example: merchant.com.adyen.merchantAccount.
      For test transactions, we recommend creating a merchant identifier with .test at the end. For example: merchant.com.adyen.merchantAccount.test.
    3. Log in to your Customer Area and go to Developers > API credentials. Select the web service user that will execute your Apple Pay transactions (ws@Company.[YourCompanyAccount]).
    4. In Wallet payment methods > Apple Pay, select + Add.
    5. Select Use your own certificate > Continue.
    6. Enter the merchant identifier and select Download CSR > Continue.
    7. Save the CSR. You will need it to create the payment processing certificate.

    Create a payment processing certificate

    1. Log in to your Apple Developer account at https://developer.apple.com.
    2. Follow the Apple Developer Account Help instructions to create a payment processing certificate:
      • Select the merchant identifier you created in the previous step.
      • Skip the step to create a certificate signing request.
      • In the step to select the certificate signing request file, select the CSR you downloaded from your Customer Area.
      • If a question Will payments associated with this Merchant ID be processed exclusively in China? or similar appears, answer No and continue.
      • Download and save the generated payment processing certificate (.cer file).
    3. Return to your Customer Area and go to Developers > API credentials. Select the web service user that will execute your Apple Pay transactions (ws@Company.[YourCompanyAccount]).
    4. Select the merchant identifier.
    5. Upload the payment processing certificate and select Continue.

    Register and validate your merchant domain

    1. Log in to your Apple Developer account at https://developer.apple.com.
    2. Follow the Apple Developer Account Help instructions to register a merchant domain. Make sure you select the merchant identifier you created earlier.

    Create a merchant identity certificate

    For each transaction, you need to request an Apple Pay payment session using your Merchant Identity Certificate.

    1. Log in to your Apple Developer account at https://developer.apple.com.

    2. Follow the Apple Developer Account Help instructions to create a merchant identity certificate. Make sure you select the merchant identifier you created earlier. Follow the instructions from Apple to create a CSR yourself (the CSR you received from Adyen cannot be used for this step).

    3. Download and save the generated merchant identity certificate (.cer file).

    4. Add the merchant identity certificate to your keychain.

    5. Export the certificate from your keychain as a p12 file.

    6. Convert the p12 file to a PEM file using the following command:

      openssl pkcs12 -in your-file.p12 -out apple-pay-cert.pem -nodes -clcerts

    7. Upload the apple-pay-cert.pem file to your server. When requesting an Apple Pay payment session, use the full path to this file.

Bancontact mobile

To use Bancontact mobile:

  1. In your Customer Area, go to Developers > Additional data.
  2. Under 3D Secure select the checkbox for 3DS2 Additional Fields.

Bizum

To use Bizum:

  1. Make sure that you have a contract with a local supported bank (the acquirer). Visit Bizum's official site to see a list of available banks.
  2. Receive your MID and Terminal ID from the acquirer.
  3. Inform the acquirer that Adyen will process payments for you so they can connect your MID with Adyen as a gateway. Adyen's IPSP number for e-commerce and Bizum operations is 31710.

DuitNow

To use DuitNow, contact our Support Team to add DuitNow in your Customer Area.

Fastlane by PayPal

To use Fastlane by PayPal:

  1. Create a PayPal developer account, if you do not already have one.
  2. Under your PayPal developer account, create a PayPal business sandbox account.
  3. When you add Fastlane by PayPal in your Customer Area, we send an activation link to your email. Use the activation link to give permission to process Fastlane transactions on your PayPal business sandbox account.

Google Pay

To use Google Pay, follow the setup steps in the Google Pay documentation.

MobilePay

To make MobilePay payouts:

  1. Contact our Support Team to get approval.
  2. Set up recurring lifecycle webhooks: In your Customer Area, go to Developers > Webhooks > Create new webhook > Add Recurring tokens life cycle events. Select the events recurring.token.created and recurring.token.disabled.

Open Banking

To use Open Banking, contact our Support Team to add Open Banking in your Customer Area.

Pay by Bank (Europe)

To use Pay by Bank (Europe), contact our Support Team to add Pay by Bank in your Customer Area.

Pay by Bank (US)

To use Pay by Bank (US), contact our Support Team to add Pay by Bank in your Customer Area.

PayPal

To use PayPal:

  1. Create a PayPal developer account, if you do not already have one.
  2. Under your PayPal developer account, create a PayPal business sandbox account and a PayPal personal sandbox account.
  3. Add PayPal in your Customer Area. Specify an email address where you want to receive the activation link.
  4. Use the activation link to give Adyen permission to process PayPal transactions on your PayPal business sandbox account.

PayPay

To use PayPay, contact our Support Team to add PayPay in your Customer Area.

PromptPay

To use PromptPay, contact our Support Team to add PromptPay in your Customer Area.

Riverty

Before activating Riverty, contact your account manager to verify if you are eligible for Enterprise pricing. Activating Riverty defaults the pricing to standard pricing.

Scalapay

Before activating Scalapay, contact your account manager to verify if you are eligible for Enterprise pricing. Activating Scalapay defaults the pricing to standard pricing.

Titres Restaurant

To use Titres Restaurant:

  1. Get an official authorization from the Mealvoucher National Commission. From them, you receive a Carte de domiciliation CONECS with your CONECS MID.
  2. For each meal voucher that you want to accept, contact the meal voucher issuer (Bimpli, Sodexo, or Up Déjeuner) for a contract.

Touch 'n Go

To use Touch 'n Go, contact our Support Team to add Touch 'n Go in your Customer Area.

Walley

To use Walley, contact our Support Team to add Walley in your Customer Area.

See also