Are you looking for test card numbers?

Would you like to contact support?

Atenção, esta página não se encontra disponível em Português
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 plataforma de pagamentos da Adyen.
  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/v68/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"
     }
}'

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": "8535505811653878",
    "resultCode": "Authorised",
}

See also