Page tree
Skip to end of metadata
Go to start of metadata

Contenu


Release version 4.58 - Version 21 or higher (3DSV2)

Intégration en page web


doWebPaymentRequest

Description

Required

Format

threeDSInfoInformation specific to 3DS authenticationNoObject - threeDSInfo
merchantScore
Score calculated by the merchant
(Used exclusively for CB Scoring)
NoAN


getWebPaymentDetailsResponse

Description

Required

Format

authentication3DSecureRetrieving the authentication result

Intégration en direct


doAuthorizationRequest

Description

Required

Format

linkedTransactionIDIn case of installment, recurring or split shippment payment refers to the first authorizationNoAN


doAuthorizationResponse

Description

Required

Format

linkedTransactionId

In case of installment, recurring or split shippment payment.

The value returned by the authorization server for the first authorization request shall be joined to the following requests

NoAN
resultcontainer

Aggregated result of the authentication.

In case of installment, recurring or split shippment payment, the authentication result shall be joined in each authorization request.

NoAN


manageWebWalletRequest

Description

Required

Format

threeDSInfoInformation specific to 3DS authenticationNoObject - threeDSInfo


verifyEnrollmentRequest

Description

Required

Format

orderOrder Information YesObject - order
buyerBuyer informationNoObject - buyer
submerchantPayment Facilitator InformationNoObject - subMerchant
recurringRecurring or installment informationNoObject - recurring
threeDSinfoInformation specific to 3DS authenticationNoObject - threeDSInfo
merchantScore

Merchant calculated score. Mainly for CB scoring.

NoAN
transientData to populate the 3DSV2 containerNoAN

Les objects impactés


Object orderorderExtended

More detail information about the order.

{
"deliveryProvider": "deliveryProvider",
"riskLevel": "3",
"giftCardAmount": "4000",
"giftCardCurrency": "978",
"giftCardCount": "2",
"reorderIndicator": "01"
}

ANNo





Object buyerloyaltyMemberType

Values :

0 : No program
1 : Standard/Normal
2 : Silver
3 : Gold/Premium
4 : Platinium
9 : Subscription in progress
99 : Special or Other

NoAN2
buyerExtended

Past events about buyer.

{

  "buyerExtendedHistory": { 
{
  "suspiciousActivity": "Y",
  "firstOrderDate": "2018-01-01",
  "lastOrderDate": "2018-09-09",
  "totalAmount": "200",
  "totalCurrency": "978",
  "lastChange": "2018-02-02",
  "lastPasswordChange": "2018-03-03",
  "provisionAttempsDay": "10",
  "paymentAccountAge": "11",
  "orderCount6Months": "10",
  "orderAmount6Months": "10",
  "transactionCountDay": "10",
  "transactionCountYear": "10"
  }
}


NoAN
merchantAuthenticationInformation about cardholder to authenticate to the merchantNoObject merchantAuthentication





Object addressemail

Specificity of ShippingAdress:

For electronic delivery, the email address to which the merchandise is delivered.

NoAN150
AddressCreateDateCreation date of the address in the merchant's systemNoAN10





Object merchantAuthenticationmethod

Mechanism used by the Cardholder to authenticate to the merchant

See table values Codes - merchantAuthentication

NoN2
date

Date and time in UTC of the buyer authentication

DD/MM/YYYY hh:mm:ss

NoAN16





Object authentication3DSecureresultContainer

Container gathering the authentication result parameters.

NoAN
authenticationResult

Content of message :

PARES = V1 
CRES   = V2 (base64 encoded)
Empty in case of frictionless authentication

NoAN





Object threeDSInfoChallengeIndIndicates whether a challenge is requested for this transaction, see values Codes - ChallengeIndNoAN2
threeDSReqPriorAuthData

Data that documents and supports a specific authentication process.

In the current version of the specification this data element is not defined in detail, however the intention is that for each 3DS Requestor Authentication Method, this field carry data that the ACS can use to verify the authentication process. In future versions of the specification, these details are expected to be included.

NoAN2048
threeDSReqPriorAuthMethodMechanism used by the Cardholder to previously authenticate to the 3DS Requestor, see values Codes - threeDSReqPriorAuthMethodNoAN2
threeDSReqPriorAuthTimestampDate and time in UTC of the prior cardholder authenticationNoAN16
browserParameters of the shopper web browser. ConditionalObject - browser
sdkParameters of the shopper application. ConditionalObject - sdk
threeDSMethodNotificationURLFully qualified URL where the merchant receive the notification of the completion result of the 3DS Method (server to server notification)YesAN255
threeDSMethodResultIndicates whether the 3DS Method successfully completed.ConditionalAN1





Object browseracceptHeaderExact content of the HTTP accept headers as sent to the merchant from the shopper’s browserYesAN2048
javaEnabled

Boolean that represents the ability of the cardholder browser to execute Java

YesAN1
languageValue representing the browser languageYesAN6
colorDepth

Value representing the bit depth of the colour palette for displaying images, in bits per pixel

Obtained from Cardholder browser using the screen.colorDepth property

Codes - colorDepth

YesAN2
screenHeight

Total height of the Cardholder’s screen in pixels.

YesAN6
screenWidthTotal width of the cardholder’s screen in pixelsYesAN6
timeZoneOffsetTime difference between UTC time and the Cardholder browser local time, in minutesYesAN5
userAgentExact content of the HTTP user-agent headerYesAN2048





Object sdkdeviceRenderingOptionsIF

Lists all of the SDK Interface types that the device supports for displaying specific challenge user interfaces within the SDK.

Values accepted:
• 01 = Native
• 02 = HTML
• 03 = Both

YesAN2
deviceRenderOptionsUI

Lists all UI types that the device supports for displaying specific challenge user interfaces within the SDK.

String values accepted:

• 01 = Text
• 02 = Single Select
• 03 = Multi Select
• 04 = OOB
• 05 = HTML Other (valid only for HTML UI)

YesAN2
appID

Universally unique ID created upon all installations and updates of the 3DS Requestor App on a Consumer Device. This will be newly generated and stored by the 3DS SDK for each installation or update.

Length: 36 characters with JSON Data Type.

Canonical format as defined in IETF RFC 4122. This may utilise any of the specified versions as long as the output meets specified.

YesAN36
ephemPubKey

Public key component of the ephemeral key pair generated by the 3DS SDK and used to establish session keys between the 3DS SDK and ACS.

In AReq, this data element is present as its own object.

In ARes, this data element is contained within the ACS Signed Content JWS Object.

YesAN256
maxTimeout

Indicates maximum amount of time (in minutes) for all exchanges.

Greater than or = 05

YesN2
referenceNumberIdentifies the vendor and version for the 3DS SDK that is integrated in a 3DS Requestor App, assigned by EMVCo when the 3DS SDK is approved.YesAN32
transIDUniversally unique transaction identifier assigned by the 3DS SDK to identify a single transaction.YesAN36





Object merchantAuthenticationmethod

Mechanism used by the Cardholder to authenticate to the merchant

See table values Codes - merchantAuthentication

NoN2
date

Date and time in UTC of the buyer authentication

Format : DD/MM/YYYY hh:mm:ss

NoAN16

Les codes retour utilisés

Consulter la liste des codes retour ici.