• France
status page
Demo shops
assistance
FAQContact support
Search
Categories
Tags
docs.
France
Spain
Europe (English)
India
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
SDD mandates by REST API
Snippets
Payment methods
Plugins
Marketplace
Guides
Merchant Back Office
Back Office Expert
Functional guides

3DS2 - Successful authentication (SUCCESS)

To test this scenario, use one of the card numbers below:

CARD Expiry date Label
4970100000000022 To be chosen VISA
5970100300000026 To be chosen MASTERCARD
378283000000002 To be chosen AMEX

Exchange flow

1. Initial call to the PCI/Charge/CreatePayment service with a card enrolled in 3DS1.

{
 "amount": "9990",
  "currency": "EUR",
  "paymentForms": [
	{
	  "paymentMethodType": "CARD",
	  "pan": "4970100000000022",			    
	  "expiryMonth": "11",
	  "expiryYear": "27",
	  "securityCode": "123"			  
	}
  ],  
  "customer": {
	"email": "sample@example.com"
  },
  "authenticationDetails": {
    "protocol": {
      "name": "THREEDS",
      "version": "1.0.2",
      "directoryServer": "VISA"
    },
    "status":"SUCCESS",	
    "commerceIndicator":"05",
    "authenticationValue":"Q2F2dkNhdnZDYXZ2Q2F2dkNhdnY=",
    "authValueAlgorithm":"2",		
    "xid":"SGJSVVNmRmljVVRGU0RnRTRDQ2g="   
  } 			
}

2. Return from the payment gateway server with the final payment result.

{
  "webService": "PCI/Charge/CreatePayment",
  "version": "V4",
  "applicationVersion": "5.36.0",
  "status": "SUCCESS",
  "answer": {
    "shopId": "12345678",
    "orderCycle": "CLOSED",
    "orderStatus": "PAID",
    "serverDate": "2022-06-09T09:12:14+00:00",
    "orderDetails": {
      "orderTotalAmount": 1230,
      "orderEffectiveAmount": 1230,
      "orderCurrency": "EUR",
      "mode": "TEST",
      "orderId": null,
      "metadata": null,
      "_type": "V4/OrderDetails"
    },
    "customer": {
      "billingDetails": {
        "address": null,
        "category": null,
        "cellPhoneNumber": null,
        "city": null,
        "country": null,
        "district": null,
        "firstName": null,
        "identityCode": null,
        "identityType": null,
        "language": "FR",
        "lastName": null,
        "phoneNumber": null,
        "state": null,
        "streetNumber": null,
        "title": null,
        "zipCode": null,
        "legalName": null,
        "_type": "V4/Customer/BillingDetails"
      },
      "email": "sample@example.net",
      "reference": null,
      "shippingDetails": {
        "address": null,
        "address2": null,
        "category": null,
        "city": null,
        "country": null,
        "deliveryCompanyName": null,
        "district": null,
        "firstName": null,
        "identityCode": null,
        "lastName": null,
        "legalName": null,
        "phoneNumber": null,
        "shippingMethod": null,
        "shippingSpeed": null,
        "state": null,
        "streetNumber": null,
        "zipCode": null,
        "_type": "V4/Customer/ShippingDetails"
      },
      "extraDetails": {
        "browserAccept": null,
        "fingerPrintId": null,
        "ipAddress": "163.116.174.22",
        "browserUserAgent": null,
        "_type": "V4/Customer/ExtraDetails"
      },
      "shoppingCart": {
        "insuranceAmount": null,
        "shippingAmount": null,
        "taxAmount": null,
        "cartItemInfo": null,
        "_type": "V4/Customer/ShoppingCart"
      },
      "_type": "V4/Customer/Customer"
    },
    "transactions": [
      {
        "shopId": "12345678",
        "uuid": "39c5e08ca1d6444286caf180d50d9130",
        "amount": 1230,
        "currency": "EUR",
        "paymentMethodType": "CARD",
        "paymentMethodToken": null,
        "status": "PAID",
        "detailedStatus": "AUTHORISED",
        "operationType": "DEBIT",
        "effectiveStrongAuthentication": "ENABLED",
        "creationDate": "2022-06-09T09:12:13+00:00",
        "errorCode": null,
        "errorMessage": null,
        "detailedErrorCode": null,
        "detailedErrorMessage": null,
        "metadata": null,
        "transactionDetails": {
          "liabilityShift": "YES",
          "effectiveAmount": 1230,
          "effectiveCurrency": "EUR",
          "creationContext": "CHARGE",
          "cardDetails": {
            "paymentSource": "EC",
            "manualValidation": "NO",
            "expectedCaptureDate": "2022-06-09T09:12:13+00:00",
            "effectiveBrand": "VISA",
            "pan": "497010XXXXXX0022",
            "expiryMonth": 9,
            "expiryYear": 2027,
            "country": "FR",
            "issuerCode": null,
            "issuerName": "Banque de démo et de l'innovation",
            "effectiveProductCode": "F",
            "legacyTransId": "925305",
            "legacyTransDate": "2022-06-09T09:12:13+00:00",
            "paymentMethodSource": "NEW",
            "authorizationResponse": {
              "amount": 1230,
              "currency": "EUR",
              "authorizationDate": "2022-06-09T09:12:13+00:00",
              "authorizationNumber": "3fc95c",
              "authorizationResult": "0",
              "authorizationMode": "FULL",
              "_type": "V4/PaymentMethod/Details/Cards/CardAuthorizationResponse"
            },
            "captureResponse": {
              "refundAmount": null,
              "refundCurrency": null,
              "captureDate": null,
              "captureFileNumber": null,
              "effectiveRefundAmount": null,
              "effectiveRefundCurrency": null,
              "_type": "V4/PaymentMethod/Details/Cards/CardCaptureResponse"
            },
            "threeDSResponse": {
              "authenticationResultData": {
                "transactionCondition": null,
                "enrolled": null,
                "status": null,
                "eci": null,
                "xid": null,
                "cavvAlgorithm": null,
                "cavv": null,
                "signValid": null,
                "brand": null,
                "_type": "V4/PaymentMethod/Details/Cards/CardAuthenticationResponse"
              },
              "_type": "V4/PaymentMethod/Details/Cards/ThreeDSResponse"
            },
            "authenticationResponse": {
              "id": "e6710589-ece7-4296-86e5-092f55c50c68",
              "operationSessionId": "1c1ac5848e0e4f4cabfe41c9e45594eb",
              "protocol": {
                "name": "THREEDS",
                "version": "1",
                "network": "VISA",
                "challengePreference": "NO_PREFERENCE",
                "simulation": false,
                "_type": "V4/Charge/Authenticate/Protocol"
              },
              "value": {
                "authenticationId": {
                  "authenticationIdType": "xid",
                  "value": "SGJSVVNmRmljVVRGU0RnRTRDQ2g=",
                  "_type": "V4/Charge/Authenticate/AuthenticationId"
                },
                "authenticationValue": {
                  "authenticationValueType": "CAVV",
                  "value": "Q2F2dkNhdnZDYXZ2Q2F2dkNhdnY=",
                  "_type": "V4/Charge/Authenticate/AuthenticationValue"
                },
                "status": "SUCCESS",
                "commerceIndicator": "05",
                "extension": {
                  "authenticationType": "THREEDS_V1",
                  "algorithm": "2",
                  "_type": "V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV1"
                },
                "_type": "V4/Charge/Authenticate/AuthenticationResult"
              },
              "_type": "V4/AuthenticationResponseData"
            },
            "installmentNumber": null,
            "installmentCode": null,
            "markAuthorizationResponse": {
              "amount": null,
              "currency": null,
              "authorizationDate": null,
              "authorizationNumber": null,
              "authorizationResult": null,
              "_type": "V4/PaymentMethod/Details/Cards/MarkAuthorizationResponse"
            },
            "cardHolderName": null,
            "identityDocumentNumber": null,
            "identityDocumentType": null,
            "initialIssuerTransactionIdentifier": null,
            "productCategory": null,
            "nature": null,
            "_type": "V4/PaymentMethod/Details/CardDetails"
          },          
          "acquirerDetails": null,
          "fraudManagement": {
            "riskControl": [],
            "riskAnalysis": [],
            "_type": "V4/PaymentMethod/Details/FraudManagement"
          },
          "subscriptionDetails": {
            "subscriptionId": null,
            "_type": "V4/PaymentMethod/Details/SubscriptionDetails"
          },
          "parentTransactionUuid": null,
          "mid": "9876543",
          "sequenceNumber": 1,
          "taxAmount": null,
          "preTaxAmount": null,
          "taxRate": null,
          "externalTransactionId": null,
          "nsu": null,
          "tid": "001",
          "acquirerNetwork": "CB",
          "taxRefundAmount": null,
          "userInfo": null,
          "paymentMethodTokenPreviouslyRegistered": null,
          "occurrenceType": "UNITAIRE",
          "_type": "V4/TransactionDetails"
        },
        "_type": "V4/PaymentTransaction"
      }
    ],
    "subMerchantDetails": null,
    "_type": "V4/Payment"
  },
  "ticket": "440a1051c49245eb89abf5aa481ac64a",
  "serverDate": "2022-06-09T09:12:14+00:00",
  "applicationProvider": "",
  "metadata": null,
  "mode": "TEST",
  "serverUrl": "",
  "_type": "V4/WebService/Response"
}
Jobs
Legal
GDPR
25.30-1.11