Adyen integration guide

Adyen 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 (saved card token) ( API )
  • Auth Only (saved card token) ( 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
External 3D Secure supportedNo
Installments supportedNo (only through SEPA)

Gateway-specific information

  • paymentType is supported

Configuration

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
Visa411111114555114203/2030AnyAnySuccess
Mastercard555534124444111503/2030AnyAnySuccess
Discover601160116011661103/2030737AnySuccess
Amex37000000010001803/2030Any
(Ex: 1234)		AnySuccess
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* or authorized
  • settled
Auth onlyWhen isAuthOnly is true, successful sale transactions will have the following status:
  • authOnly
CaptureSuccessful capture transactions will have the following statuses:
  • pending* or authorized
  • settled
VoidSuccessful void transactions will have the following status:
  • voided
RefundSuccessful refund transactions will have the following statuses:
  • pending* or authorized
  • 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.

Updated 4 months ago

What’s Next