Skip to Content
🎉 Nextra 2.0 is released. Read more →
paymentsPayment integrations, methods and settingsHow to set up the Adyen integration?

TABLE OF CONTENTS

What is Adyen Payments Integration?

Adyen Payments Integration connects an existing Adyen merchant account to TWIM CRM so you can process card transactions on supported sales channels using Adyen’s PCI-compliant infrastructure. This enables agencies and sub-accounts to meet enterprise procurement requirements while keeping payment collection inside TWIM CRM.

Adyen Payments Integration lets administrators add Adyen credentials (Company API Key and, for Live, the Live URL Prefix) in TWIM CRM and route eligible card transactions through Adyen on selected channels such as Invoices and Payment Links.

Key Benefits of Adyen Payments Integration

Understanding the value helps you decide when to choose Adyen over other processors connected to your sub-account. These benefits focus on enterprise needs, geographic coverage, and security.

  • Enterprise readiness: win deals with companies that standardize on Adyen.
  • 3D Secure (3DS) support: adds an extra authentication layer for high-risk or cross-border payments.
  • Broader EU & North America coverage: onboard businesses operating in those regions with a single provider.
  • Fast client adoption: existing Adyen merchants can plug in credentials and start selling quickly.

Prerequisites

Preparing these items avoids connection errors and speeds up onboarding.

  • Active Adyen merchant account approved for processing (Test and Live).
  • Company API Key for Test and Live environments.
  • Live URL Prefix available in your Adyen account (used only for Live).
  • TWIM CRM account with Admin access to Payments.

At-a-Glance: Credentials, Capabilities, Regions

Use this quick reference to confirm which credentials are required, what the integration supports today, and where it’s available. Keep it handy during setup and client scoping to avoid misconfiguration or overpromising.

CategoryItemDetails
Credential RequirementsLive modeCompany API Key and Live URL Prefix
Test (Sandbox)Company API Key
Live URL PrefixHex-encoded string that precedes live endpoints (e.g., 1797a841fbb37ca7-MyStore); found in Adyen dev settings
Supported CapabilitiesPayment methodsCard payments (credit/debit)
Authentication3D Secure (3DS) supported
TWIM CRM surfacesInvoices; Payment Links; Stores; Forms/Funnels order forms (where card payments are supported)
Supported Regions & CurrenciesRegionsEU/UK; United States; Canada
Currencies & settlementDetermined by Adyen account approval and configuration

How To Setup Adyen Payments Integration

Follow these steps to connect Adyen securely and verify everything works before going live.

  1. In your TWIM CRM sub-account, Go to Payments → Integrations. Click Connect Adyen.
  2. Choose Live or Test from the toggle.
  3. Enter your Company API Key. How to find Adyen API Key? 
  4. (Live only) Paste your Live URL Prefix.
  5. Click Save. A success message confirms the connection.

Testing with Adyen (Sandbox)

Testing prevents unintended charges and helps verify 3DS behavior before switching to Live.

  • Use Test mode to simulate card payments; no real charges occur.
  • Use Adyen-provided test card numbers and follow any 3DS prompts to confirm authentication flows.
  • After successful tests, switch the integration to Live, add the Live URL Prefix, and repeat a low-value verification payment.

Refunds & Disputes

Knowing where to issue refunds and manage disputes reduces delays and chargeback risk for your clients.

  • Refunds: If refunds are enabled for your account within TWIM CRM, you can issue full or partial refunds from Payments → Transactions (or from the related Invoice). Otherwise, refunds can be initiated directly in your Adyen dashboard.
  • Disputes/Chargebacks: Disputes are managed in Adyen. Monitor dispute notifications and provide evidence per Adyen’s timelines and guidance.
  • Refund timing, fees, and settlement adjustments are determined by Adyen.

Frequently Asked Questions

Q: Can I enable Apple Pay or Google Pay through Adyen in TWIM CRM?
Not at launch. The integration currently supports card payments only.

Q: Is there extra TWIM CRM transaction pricing on top of Adyen fees?
No. Transactions are processed by Adyen under your existing Adyen pricing.

Q: What happens if I leave the Live URL Prefix blank in Live mode?
Live transactions will fail because Adyen cannot route the request without the prefix.

Q: Can I connect both Stripe and Adyen to the same sub-account?
Yes. Keep multiple gateways connected and select a Default Provider per channel.

Q: Does 3DS require a TWIM CRM setting?
No. 3DS challenge flows are handled by Adyen during checkout when required.

Q: Where do I see Adyen payouts and fees?
In your Adyen dashboard. Settlement timing and fees are determined by Adyen.

Q: Is the Adyen integration card-only at launch?
Yes. The current release supports credit/debit card payments. Wallets (Apple/Google Pay), BNPL, and terminals are not available yet.

  • How to integrate Razorpay within the CRM
  • Supported Payment Providers & Methods by Product Area (What Works Where)
  • Manage payment methods displayed with Stripe integration
  • How to set up the NMI integration?
  • Managing Granular Permissions for Payments
  • Getting Started - Connect Stripe
  • How to set up the NMI integration?
  • What Payment Gateways supported in Affiliate manager for Product Sales?
  • Getting Started with Gift Cards
  • Bank-Only Transfers for Invoice Payments (SEPA & ACH)
  • Shipping: How to Connect a Shippo Integration?
Square Payments: Smoother and More Secure Payments with 3D Secure (3DS)Missing payment methods in Stripe checkout element