Are you looking for test card numbers?

Would you like to contact support?

Default icon

Authorisation-only integration

Authorise a payment with 3D Secure authenticated data.

Learn how to submit a payment authorisation with Adyen, using authentication data from a third-party 3D Secure provider.

This page describes passing authentication data in a /payments API request. If you are using the /authorise endpoint, refer to 3D Secure Classic integration.

Before you begin

Before you begin to integrate, make sure you have followed the Get started with Adyen guide to:

  • Get an overview of the steps needed to accept live payments.
  • Create your test account.

After you have created your test account:

  1. Get your API Key. Save a copy as you'll need it for API calls you make to the Adyen payments platform.
  2. Check that you are using v46 or later of the /payments endpoint.

Get authentication data

If you didn't authenticate with Adyen, refer to Mapping Adyen parameters to EMVCo ones.

To authorise a 3D Secure 1 authenticated payment, you need the following data:

Send a payment authorisation request with 3D Secure authentication data

Co-branded cards

If you are authorising for a co-branded card, you need to set the paymentMethod.type value to the scheme that authenticated the payment. For example, if you are authorising for a card co-branded with Visa and Cartes Bancaires, set the value to either visa or cartebancaire, depending on which scheme performed the authentication. Otherwise, the authorisation can be refused.

Sample request

/payments request
curl https://checkout-test.adyen.com/v69/payments/ \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
  "amount": {
    "currency": "EUR",
    "value": 1000
  },
  "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
  "reference": "YOUR_ORDER_NUMBER",
  "channel": "Web",
  "mpiData": {
    "cavv": "3q2+78r+ur7erb7vyv66vv////8=",
    "cavvAlgorithm": "1",
    "eci": "05",
    "xid": "ODUzNTYzOTcwODU5NzY3Qw==",
    "directoryResponse": "Y",
    "authenticationResponse": "Y"
  },
  "paymentMethod": {
    "type": "visa",
    "number": "4917610000000000",
    "expiryMonth": "10",
    "expiryYear": "2020",
    "holderName": "John Smith",
    "cvc": "737"
  },
  "shopperInteraction": "ContAuth",
  "recurringProcessingModel": "Subscription"
}'

Sample response

You will receive an  Authorised resultCode if the payment authorisation was successful. Otherwise,  see  Result codes for a complete list of  values and the actions that you need to take.

/payments response
{
    ...
    "pspReference": "V4HZ4RBFJGXXGN82",
    "resultCode": "Authorised",
}

See also