Arborescence des pages

Vous regardez une version antérieure (v. /display/DT/3DSV2+-+La+liste+des+impacts+de+l%27API+Payline) de cette page.

afficher les différences afficher l'historique de la page

Vous regardez la version actuelle de cette page. (v. 1) afficher la version suivante »



Rel.4.58 - Version 21 or higher (3DSV2)

Element

Description

Required

Format

Condition
Service doWebPaymentRequest



threeDSInfoInformation specific to 3DS authenticationNoObject - threeDSInfo

version 21 or higher (3DSV2) - Rel.4.58

merchantScore
Score calculated by the merchant
(Used exclusively for CB Scoring)
NoAN

version 21 or higher (3DSV2) - Rel.4.58

Service doAuthorizationRequest



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

Release 4.58 or version 21 (3DSV2)

Service doAuthorizationResponse



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

NoANRelease 4.58 or version 21 (3DSV2)
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.

NoANRelease 4.58 or version 21 (3DSV2)
Service manageWebWalletRequest



threeDSInfoInformation specific to 3DS authenticationNoObject - threeDSInfoRelease 4.58 or version 21 (3DSV2)
Service verifyEnrollmentRequest



orderOrder Information YesObject - order

Version 21or higher Release 4.58 (3DSV2)

buyerBuyer informationNoObject - buyer

Version 21or higher, Release 4.58 (3DSV2)

submerchantPayment Facilitator InformationNoObject - subMerchant

Version 21or higher, Release 4.58 (3DSV2)

recurringRecurring or installment informationNoObject - recurring

Version 21or higher, Release 4.58 (3DSV2)

threeDSinfoInformation specific to 3DS authenticationNoObject - threeDSInfo

Version 21or higher, Release 4.58 (3DSV2)

merchantScore

Merchant calculated score. Mainly for CB scoring.

NoAN

Version 21or higher, Release 4.58 (3DSV2)

Object order



orderExtended

More detail information about the order.

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

version 21 or higher (3DSV2)

Object buyer



loyaltyMemberType

Values :

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

NoAN2

from version 21 or higher (3DSV2), 

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

from version 21 or higher (3DSV2)

merchantAuthenticationInformation about cardholder to authenticate to the merchantNoObject merchantAuthentication

version 21 or higher (3DSV2) - Rel.4.58

Object address



email

Specificity of ShippingAdress:

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

NoAN150

version 21 or higher (3DSV2)

AddressCreateDateCreation date of the address in the merchant's systemNoAN10

version 21 or higher (3DSV2)

Object merchantAuthentication





method

Mechanism used by the Cardholder to authenticate to the merchant

See table values Codes - merchantAuthentication

NoN24.58  (3DSV2)
date

Date and time in UTC of the buyer authentication

DD/MM/YYYY hh:mm:ss

NoAN164.58  (3DSV2)
Object authentication3DSecure



resultContainer

Container gathering the authentication result parameters.

NoANRel.4.58 - version 21 or higher (3DSV2)
authenticationResult

Content of message :

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

NoANRel.4.58 - version 21 or higher (3DSV2)
Object threeDSInfo



ChallengeIndIndicates whether a challenge is requested for this transaction, see values Codes - ChallengeIndNoAN2Release 4.58 (3DSV2)
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

For Future usage

Release 4.58 (3DSV2)

threeDSReqPriorAuthMethodMechanism used by the Cardholder to previously authenticate to the 3DS Requestor, see values Codes - threeDSReqPriorAuthMethodNoAN2

Recommended.

Release 4.58 (3DSV2)

threeDSReqPriorAuthTimestampDate and time in UTC of the prior cardholder authenticationNoAN16

Recommended.

Release 4.58 (3DSV2)

browserParameters of the shopper web browser. ConditionalObject - browser

Mandatory in verifyEnrollment when the buyer is connected to a web browser.

Release 4.58 (3DSV2)

sdkParameters of the shopper application. ConditionalObject - sdk

Mandatory in verifyEnrollment when the buyer is connected to mobile application.

Release 4.58 (3DSV2)

threeDSMethodNotificationURLFully qualified URL where the merchant receive the notification of the completion result of the 3DS Method (server to server notification)YesAN255Release 4.58 (3DSV2)
threeDSMethodResultIndicates whether the 3DS Method successfully completed.ConditionalAN1

Must be present if the ACS required the buyer's browser to connect to the 3DS method.

Release 4.58 (3DSV2)

Object browser



acceptHeaderExact content of the HTTP accept headers as sent to the merchant from the shopper’s browserYesAN2048Version 21 or higher (3DSV2)
javaEnabled

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

YesAN1Version 21 or higher (3DSV2)
languageValue representing the browser languageYesAN6Version 21 or higher (3DSV2)
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

YesAN2Version 21 or higher (3DSV2)
screenHeight

Total height of the Cardholder’s screen in pixels.

YesAN6Version 21 or higher (3DSV2)
screenWidthTotal width of the cardholder’s screen in pixelsYesAN6Version 21 or higher (3DSV2)
timeZoneOffsetTime difference between UTC time and the Cardholder browser local time, in minutesYesAN5Version 21 or higher (3DSV2)
userAgentExact content of the HTTP user-agent headerYesAN2048Version 21 or higher (3DSV2)
Object sdk



deviceRenderingOptionsIF

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

YesAN2Version 21 or higher (3DSV2)
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)

YesAN2Version 21 or higher (3DSV2)
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.

YesAN36Version 21 or higher (3DSV2)
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.

YesAN256Version 21 or higher (3DSV2)
maxTimeout

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

Greater than or = 05

YesN2Version 21 or higher (3DSV2)
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.YesAN32Version 21 or higher (3DSV2)
transIDUniversally unique transaction identifier assigned by the 3DS SDK to identify a single transaction.YesAN36Version 21 or higher (3DSV2)
Object merchantAuthentication



method

Mechanism used by the Cardholder to authenticate to the merchant

See table values Codes - merchantAuthentication

NoN2Version 21 or higher (3DSV2)
date

Date and time in UTC of the buyer authentication

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

NoAN16Version 21 or higher (3DSV2)



  • Aucune étiquette