• 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 - Frictionless authentication, without 3DS Method (deprecated)

Deprecated integration. It is recommended to integrate the new version V4.1/PCI/Charge/CreatePayment: Integration guide

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

CARD Expiry date Label
4970110000000013 To be chosen VISA
5100010000002045 To be chosen MASTERCARD
375900000000008 To be chosen AMEX

Exchange flow

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

{
  "amount": "9990",
  "currency": "EUR",
  "paymentForms": [
    {
      "paymentMethodType": "CARD",
      "pan": "375900000000008",			    
      "expiryMonth": "11",
      "expiryYear": "27",
      "securityCode": "1234"			  
    }
  ],
  "device": {
    "acceptHeader":"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9",
    "colorDepth":"24",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled":false,
    "language":"fr-FR",
    "screenHeight":"720",
    "screenWidth":"1280",
    "timeZoneOffset":"-60",
    "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 Safari/537.36"
  },
  "customer": {
    "email": "sample@example.com"
  }			
}

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

{
    "webService":"PCI/Charge/CreatePayment",
    "version":"V4",
    "applicationVersion":"5.29.0",
    "status":"SUCCESS",
    "answer":{
        "shopId":"12345678",
        "orderCycle":"CLOSED",
        "orderStatus":"PAID",
        "serverDate":"2021-12-01T10:05:07+00:00",
        "orderDetails":{
            "orderTotalAmount":9990,
            "orderEffectiveAmount":9990,
            "orderCurrency":"EUR",
            "mode":"TEST",
            "orderId":null,
            "_type":"V4/OrderDetails"
        },
        "customer":{
            "billingDetails":{
                "address":null,
                "category":null,
                "cellPhoneNumber":null,
                "city":null,
                "country":null,
                "district":null,
                "firstName":null,
                "identityCode":null,
                "language":"FR",
                "lastName":null,
                "phoneNumber":null,
                "state":null,
                "streetNumber":null,
                "title":null,
                "zipCode":null,
                "legalName":null,
                "_type":"V4/Customer/BillingDetails"
            },
            "email":"sample@example.com",
            "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":"185.244.73.2",
                "browserUserAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 Safari/537.36","_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":"aa8402dbbea24f29af8c0af3ff180725",
                "amount":9990,
                "currency":"EUR",
                "paymentMethodType":"CARD",
                "paymentMethodToken":null,
                "status":"PAID",
                "detailedStatus":"AUTHORISED",
                "operationType":"DEBIT",
                "effectiveStrongAuthentication":"DISABLED",
                "creationDate":"2021-12-01T10:05:06+00:00",
                "errorCode":null,
                "errorMessage":null,
                "detailedErrorCode":null,
                "detailedErrorMessage":null,
                "metadata":null,
                "transactionDetails":{
                    "liabilityShift":"YES",
                    "effectiveAmount":9990,
                    "effectiveCurrency":"EUR",
                    "creationContext":"CHARGE",
                    "cardDetails":{
                        "paymentSource":"EC",
                        "manualValidation":"NO",
                        "expectedCaptureDate":"2021-12-01T10:05:06+00:00",
                        "effectiveBrand":"AMEX",
                        "pan":"375900XXXXX0008",
                        "expiryMonth":11,
                        "expiryYear":2027,
                        "country":null,
                        "issuerCode":null,
                        "issuerName":null,
                        "effectiveProductCode":null,
                        "legacyTransId":"912946",
                        "legacyTransDate":"2021-12-01T10:05:06+00:00",
                        "paymentMethodSource":"NEW",
                        "authorizationResponse":{
                            "amount":9990,
                            "currency":"EUR",
                            "authorizationDate":"2021-12-01T10:05:06+00:00",
                            "authorizationNumber":"107207",
                            "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":"cfa46247-0c05-422d-9c2d-7ea49b364ee6",
                            "operationSessionId":"b4a3f7e861004f8490a624e27b264ec9",
                            "protocol":{
                                "name":"THREEDS",
                                "version":"2.1.0",
                                "network":"AMEX_SAFEKEY",
                                "challengePreference":"NO_PREFERENCE",
                                "simulation":true,
                                "_type":"V4/Charge/Authenticate/Protocol"
                            },
                            "value":{
                                "authenticationType":"FRICTIONLESS",
                                "authenticationId":{
                                    "authenticationIdType":"dsTransId",
                                    "value":"c44c8302-8b8a-406c-9150-1e7dc28d35b4",
                                    "_type":"V4/Charge/Authenticate/AuthenticationId"
                                },
                                "authenticationValue":{
                                    "authenticationValueType":"AEVV",
                                    "value":"f0mOgsjPGegqxIsm5k6moXW/A8Q=",
                                    "_type":"V4/Charge/Authenticate/AuthenticationValue"
                                },
                                "status":"SUCCESS",
                                "commerceIndicator":"05",
                                "extension":{
                                    "authenticationType":"THREEDS_V2",
                                    "threeDSServerTransID":"cfa46247-0c05-422d-9c2d-7ea49b364ee6",
                                    "dsTransID":"c44c8302-8b8a-406c-9150-1e7dc28d35b4",
                                    "acsTransID":"d95272dd-b41d-4628-ad30-92c2f9bd5f77",
                                    "_type":"V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
                                },
                                "reason":{
                                    "_type":"V4/Charge/Authenticate/AuthenticationResultReason"
                                },
                                "_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,
                        "_type":"V4/PaymentMethod/Details/CardDetails"
                    },
                    "fraudManagement":{
                        "riskControl":[],
                        "riskAnalysis":[],
                        "_type":"V4/PaymentMethod/Details/FraudManagement"
                    },
                    "subscriptionDetails":{
                        "subscriptionId":null,
                        "_type":"V4/PaymentMethod/Details/SubscriptionDetails"
                    },
                    "parentTransactionUuid":null,
                    "mid":"9499999999",
                    "sequenceNumber":1,
                    "taxAmount":null,
                    "preTaxAmount":null,
                    "taxRate":null,
                    "externalTransactionId":"000038353107207",
                    "nsu":null,
                    "tid":"001",
                    "acquirerNetwork":"AMEXGLOBAL",
                    "taxRefundAmount":null,
                    "userInfo":"API REST",
                    "paymentMethodTokenPreviouslyRegistered":null,
                    "occurrenceType":"UNITAIRE",
                    "_type":"V4/TransactionDetails"
                },
                "_type":"V4/PaymentTransaction"
            }
        ],
        "subMerchantDetails":null,
        "_type":"V4/Payment"
    },
    "ticket":"878d328230d9416d94f7add74eeb22c1",
    "serverDate":"2021-12-01T10:05:07+00:00",
    "applicationProvider":"",
    "metadata":null,
    "mode":"TEST",
    "serverUrl":"",
    "_type":"V4/WebService/Response"
}
Jobs
Legal
GDPR
25.22-1.11