3DS2 - Frictionless authentication
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. Call the PCI/Charge/CreatePayment Web Service with a 3DS2 enrolled card and FRICTIONLESS authentication details.
{
"amount": "9990",
"currency": "XPF",
"paymentForms": [
{
"paymentMethodType": "CARD",
"pan": "4970110000000013",
"expiryMonth": "09",
"expiryYear": "27",
"securityCode": "123"
}
],
"customer": {
"email": "sample@example.com"
},
"authenticationDetails":{
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"directoryServer":"VISA",
"challengePreference":"NO_PREFERENCE"
},
"status":"SUCCESS",
"authenticationType":"FRICTIONLESS",
"commerceIndicator":"05",
"authenticationValue":"O8QEFp6Mwe9awv/IN5VrFAAQU3U=",
"dsTransID":"42235360-e0cf-4959-abce-bd098519217c",
"exemption":"ISSUER_TRA"
}
}2. Return from the payment gateway server with the payment result.
{
"webService":"PCI/Charge/CreatePayment",
"version":"V4",
"applicationVersion":"5.36.0",
"status":"SUCCESS",
"answer":{
"shopId":"70258842",
"orderCycle":"CLOSED",
"orderStatus":"PAID",
"serverDate":"2023-06-01T13:48:24+00:00",
"orderDetails":{
"orderTotalAmount":9990,
"orderEffectiveAmount":9990,
"orderCurrency":"XPF",
"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.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":"163.116.174.28",
"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":"70258842",
"uuid":"50d33550527749de936fab644bca1858",
"amount":9990,
"currency":"XPF",
"paymentMethodType":"CARD",
"paymentMethodToken":null,
"status":"PAID",
"detailedStatus":"AUTHORISED",
"operationType":"DEBIT",
"effectiveStrongAuthentication":"DISABLED",
"creationDate":"2023-06-01T13:48:23+00:00",
"errorCode":null,
"errorMessage":null,
"detailedErrorCode":null,
"detailedErrorMessage":null,
"metadata":null,
"transactionDetails":{
"liabilityShift":"YES",
"effectiveAmount":9990,
"effectiveCurrency":"XPF",
"creationContext":"CHARGE",
"cardDetails":{
"paymentSource":"EC",
"manualValidation":"NO",
"expectedCaptureDate":"2023-06-01T13:48:23+00:00",
"effectiveBrand":"VISA",
"pan":"497011XXXXXX0013",
"expiryMonth":9,
"expiryYear":2027,
"country":"FR",
"issuerCode":17807,
"issuerName":"Banque Populaire Occitane",
"effectiveProductCode":null,
"legacyTransId":"927328",
"legacyTransDate":"2023-06-01T13:48:23+00:00",
"paymentMethodSource":"NEW",
"authorizationResponse":{
"amount":9990,
"currency":XPF,
"authorizationDate":"2023-06-01T13:48:23+00:00",
"authorizationNumber":"3fea7a",
"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":"f8e21ad5-bdb3-4be8-ae38-2ce1ff16ca33",
"operationSessionId":"a12b8e4c47e4449ba87bad62d55866a2",
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"NO_PREFERENCE",
"simulation":false,
"_type":"V4/Charge/Authenticate/Protocol"
},
"value":{
"authenticationType":"FRICTIONLESS",
"authenticationId":{
"authenticationIdType":"dsTransId",
"value":"42235360-e0cf-4959-abce-bd098519217c",
"_type":"V4/Charge/Authenticate/AuthenticationId"
},
"authenticationValue":{
"authenticationValueType":"CAVV",
"value":"O8QEFp6Mwe9awv/IN5VrFAAQU3U=",
"_type":"V4/Charge/Authenticate/AuthenticationValue"
},
"status":"SUCCESS",
"commerceIndicator":"05",
"extension":{
"authenticationType":"THREEDS_V2",
"paymentUseCase":"SINGLE_PAYMENT",
"dsTransID":"42235360-e0cf-4959-abce-bd098519217c",
"requestedExemption":"ISSUER_TRA",
"_type":"V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
},
"_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":"1999888",
"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":"8f3f21f83ca84f7da354d3567c28e9bf",
"serverDate":"2023-06-01T13:48:24+00:00",
"applicationProvider":"",
"metadata":null,
"mode":"TEST",
"serverUrl":"https://api.secure.osb.pf",
"_type":"V4/WebService/Response"
}