Adyen integration guide

AdyenAdyen Adyen is a gateway that allows you to collect card payments. This guide is intended to help you implement Adyen based on your preferred integration workflow.

Services and compatibility

Supported payment types
  • Card
Supported transaction types
  • Sale ( API )
  • Auth Only ( API )
  • Capture (partial and greater than) ( API )
  • Void ( API )
  • Refund (partial and multiple) ( API )
Supported processing currenciesAUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, ILS, JPY, MXN, NOK, NZD, PLN, RUB, SEK, SGD, THB, TRY, USD, ZAR
3D Secure 1.x supportedYes
3D Secure 2.x supportedYes
Installments supportedNo

Gateway-specific information

  • paymentType is supported


Work with Integrations Support to add Adyen as a connection. You will need the following credentials from Adyen:

  • merchant account name
  • API key
  • subdomain

Required fields

  • For an initial transaction, card.securityCode is required.
  • If authenticating with 3D Secure, card.cardHolderName, customer.orderNumber, customer.billToAddressOne, customer.billToAddressTwo, customer.billToCity, customer.billToState, customer.billToPostal, and customer.billToCountry are required.

Testing data

Use the following test card information to test your Adyen configuration.

BrandCard numberExpiration dateSecurity codeCardholder nameTransaction result
(Ex: 1234)
Visa (3DS1)421234567890123703/2030737AnySuccess
Mastercard (3DS2)520128150512973603/2030737AnySuccess

Status workflows

The status of a successful transaction with Adyen varies, depending on the options you choose.

SaleWhen isAuthOnly is false, successful sale transactions will have the following statuses:
  • pending*
  • settled
Auth onlyWhen isAuthOnly is true, successful sale transactions will have the following status:
  • authOnly
CaptureSuccessful capture transactions will have the following statuses:
  • pending*
  • settled
VoidSuccessful void transactions will have the following status:
  • voided
RefundSuccessful refund transactions will have the following statuses:
  • pending*
  • settled

*Pending status displays as "authorized" or "AUTHORIZED" in the Nexio Dashboard; it displays as 10, meaning "authorized", in the response when querying transactions (for more information about transactionStatus, see the appropriate transactionStatus table).

If you have any additional questions or feedback, contact us.

Did this page help you?