Skip to main content

Overview

Adyen is a global payment platform that provides end-to-end payment solutions for businesses. It offers a unified platform for online, mobile, and in-store payments with advanced fraud protection and analytics.

Setup​

Adyen provides a self-service sign-up for a sandbox account. To sign up for an account visit the sign-up page and fill in the details.

Credentials​

To set up credentials for Adyen, head to their dashboard and navigate to Developers -> API credentials in the left hand sidebar. Next, create a set of credentials. You will need to create a Web Service key and give it a name. We recommend setting the name to something that describes the use for the key, e.g. "Orchestration API". For most Adyen connectors you will need to then copy some of the following details into our dashboard.

  • A server-side API key - This key can be found on the credentials page under Server Settings -> Authentication -> API key. This is the key we will use to communicate with the Adyen API from our server.
  • A client-side key - This key can be found on the credentials page under Client Settings -> Authentication -> Client key. This is the key we will use to communicate with the Adyen API from our frontend integrations. This key is mostly needed for local and alternative payment methods.
  • A merchant account - This is the public ID of your account. We need this value for most API calls. You can find this in your dashboard under Settings -> Account settings -> Merchant overview -> Name.

Production Endpoints (Conditional)​

Most live Adyen accounts have a custom API hostname configured. In those situations we need to know the value of the prefix of your domain name. For example, if your live URL is https://1797a841fbb37ca7-AdyenDemo-checkout-live.adyenpayments.com/checkout/v53/payments then the live URL prefix would be 1797a841fbb37ca7-AdyenDemo. See Live URL prefix for more details.

Allowed Origins (Conditional)​

For alternative payment methods it's essential to also enable the allowed origin for your instance. This will allow us to connect to the Adyen API from our hosted components, like Embed. For a given API credential, scroll down to the Client settings section where you will find the allowed origins configuration. Add one of the following domains based on your environment.

  • https://cdn.{instance_id}.gr4vy.app
  • https://cdn.sandbox.{instance_id}.gr4vy.app

The value of {instance_id} is the name of your instance.

Web Components Environment (Conditional)​

It is required to set the environment to load the web components from for live Adyen transactions. This mainly applies to alternative payment methods and not card payments. The environment should be set to one of the following, depending on your region. If no value is provided, a default value of live is used.

RegionEnvironment Value
Europelive
Australialive-au
USlive-us
Asia Pacific South Eastlive-apse

Webhook Format​

In the Adyen panel, "Webhook configuration" section, "Method" should be set to JSON.

Supported Payment Methods​

Adyen supports a wide range of payment methods through our platform:

  • Card Payments - Credit and debit cards from major networks
  • Alipay - Chinese digital payment platform
  • BLIK - Polish mobile payment system
  • Boleto Bancário - Brazilian bank slip payment
  • Giropay - German online banking payment
  • iDEAL - Dutch online banking payment
  • SEPA - European bank transfer system
  • Sofort - German online banking payment

Integration Benefits​

  • Global Coverage - Support for 250+ payment methods and 150+ currencies
  • Advanced Security - Built-in fraud detection and 3D Secure support
  • Unified API - Single integration for multiple payment methods
  • Real-time Processing - Instant payment confirmation and webhook notifications
  • Compliance - PCI DSS Level 1 compliance and local regulatory adherence

Getting Started​

  1. Sign up for Adyen - Create your merchant account
  2. Configure credentials - Set up API keys and merchant account
  3. Enable payment methods - Choose which payment methods to support
  4. Integrate with EFundPay - Use our unified API for all Adyen payments
  5. Test thoroughly - Use sandbox environment for development
  6. Go live - Switch to production when ready

Support​

For technical support with Adyen integration:

  • EFundPay Support - Contact our technical team
  • Adyen Support - Use Adyen's support resources
  • Adyen Documentation - Comprehensive API documentation
  • Adyen Community - Developer community forums
Powered by Docusaurus