3DS ReferenceProtocol & field guide

EMV 3-D Secure · Core specification 2.3.1.1

AReq — Authentication Request

The AReq message is the initial message in the 3-D Secure authentication flow.

Direction 3DS Server → DS → ACS

Full message description

The AReq message is the initial message in the 3-D Secure authentication flow. The 3DS Server forms the AReq message when requesting authentication of the Cardholder. It can contain Cardholder, payment, and Device information for the transaction. There is only one AReq message per authentication, except for the 3DS Requestor-Initiated SPC Authentication and Decoupled Authentication Fallback.

Explore AReq with context filters

115 top-level fields

Baseline inclusion. Effective requirements depend on transaction context. Check the field’s conditions and FAQ qualifications; select channel and category in the explorer.

FieldBaseline inclusion
acceptLanguageAccept LanguageRequired
acctIDCardholder Account IdentifierOptional
acctInfoCardholder Account InformationOptional
acctNumberCardholder Account NumberRequired
acctTypeAccount TypeConditional
acquirerBINAcquirer BINPayment · 01-PARequiredNon-payment · 02-NPAOptional
acquirerCountryCodeAcquirer Country CodeRequired
acquirerCountryCodeSourceAcquirer Country Code SourceRequired
acquirerMerchantIDAcquirer Merchant IDPayment · 01-PARequiredNon-payment · 02-NPAOptional
addrMatchAddress Match IndicatorOptional
appIpApp IP AddressConditional
billAddrCityCardholder Billing Address CityConditional
billAddrCountryCardholder Billing Address CountryConditional
billAddrLine1Cardholder Billing Address Line 1Conditional
billAddrLine2Cardholder Billing Address Line 2Conditional
billAddrLine3Cardholder Billing Address Line 3Conditional
billAddrPostCodeCardholder Billing Address Postal CodeConditional
billAddrStateCardholder Billing Address StateConditional
broadInfoBroadcast InformationOptional
browserAcceptHeaderBrowser Accept HeadersRequired
browserColorDepthBrowser Screen Color DepthConditional
browserIPBrowser IP AddressConditional
browserJavaEnabledBrowser Java EnabledConditional
browserJavascriptEnabledBrowser JavaScript EnabledRequired
browserLanguageBrowser LanguageConditional
browserScreenHeightBrowser Screen HeightConditional
browserScreenWidthBrowser Screen WidthConditional
browserTZBrowser Time ZoneConditional
browserUserAgentBrowser User-AgentRequired
cardExpiryDateCard/Token Expiry DateConditional
cardholderNameCardholder NameConditional
cardSecurityCodeCard Security CodeConditional
cardSecurityCodeStatusCard Security Code StatusConditional
cardSecurityCodeStatusSourceCard Security Code Status SourceConditional
defaultSdkTypeDefault-SDK TypeConditional
deviceBindingStatusDevice Binding StatusOptional
deviceBindingStatusSourceDevice Binding Status SourceConditional
deviceChannelDevice ChannelRequired
deviceIdBrowser User Device IDConditional
deviceInfoDevice InformationConditional
deviceRenderOptionsDevice Rendering Options SupportedRequired
dsReferenceNumberDS Reference NumberConditional
dsTransIDDS Transaction IDConditional
dsURLDS URLConditional
emailCardholder Email AddressConditional
homePhoneCardholder Home Phone NumberConditional
mccMerchant Category CodePayment · 01-PARequiredNon-payment · 02-NPAOptional
merchantCountryCodeMerchant Country CodePayment · 01-PARequiredNon-payment · 02-NPAOptional
merchantNameMerchant NamePayment · 01-PARequiredNon-payment · 02-NPAOptional
merchantRiskIndicatorMerchant Risk IndicatorOptional
messageCategoryMessage CategoryRequired
messageExtensionMessage ExtensionConditional
messageTypeMessage TypeRequired
messageVersionMessage Version NumberRequired
mobilePhoneCardholder Mobile Phone NumberConditional
multiTransactionMulti-TransactionOptional
notificationURLNotification URLRequired
payeeOriginPayee OriginConditional
payTokenIndEMV Payment Token IndicatorConditional
payTokenInfoEMV Payment Token InformationOptional
payTokenSourceEMV Payment Token SourceConditional
purchaseAmountPurchase AmountPayment · 01-PARequiredNon-payment · 02-NPAConditional
purchaseCurrencyPurchase CurrencyPayment · 01-PARequiredNon-payment · 02-NPAConditional
purchaseDatePurchase Date & TimePayment · 01-PARequiredNon-payment · 02-NPAConditional
purchaseExponentPurchase Currency ExponentPayment · 01-PARequiredNon-payment · 02-NPAConditional
purchaseInstalDataInstalment Payment DataConditional
recurringAmountRecurring AmountConditional
recurringCurrencyRecurring CurrencyConditional
recurringDateRecurring DateConditional
recurringExpiryRecurring ExpiryConditional
recurringExponentRecurring Currency ExponentConditional
recurringFrequencyRecurring FrequencyConditional
recurringIndRecurring IndicatorConditional
sdkAppIDSDK App IDRequired
sdkEncDataSDK Encrypted DataConditional
sdkEphemPubKeySDK Ephemeral Public Key (Qc)Required
sdkMaxTimeoutSDK Maximum TimeoutRequired
sdkReferenceNumberSDK Reference NumberRequired
sdkServerSignedContentSDK Server Signed ContentConditional
sdkTransIDSDK Transaction IDRequired
sdkTypeSDK TypeRequired
sellerInfoSeller InformationOptional
shipAddrCityCardholder Shipping Address CityConditional
shipAddrCountryCardholder Shipping Address CountryConditional
shipAddrLine1Cardholder Shipping Address Line 1Conditional
shipAddrLine2Cardholder Shipping Address Line 2Conditional
shipAddrLine3Cardholder Shipping Address Line 3Conditional
shipAddrPostCodeCardholder Shipping Address Postal CodeConditional
shipAddrStateCardholder Shipping Address StateConditional
spcIncompIndSPC Incompletion IndicatorConditional
splitSdkTypeSplit-SDK TypeConditional
taxIdTax IDConditional
threeDSCompInd3DS Method Completion IndicatorRequired
threeDSMethodId3DS Method IDConditional
threeDSRequestorAppURLInd3DS Requestor App URL IndicatorRequired
threeDSRequestorAuthenticationInd3DS Requestor Authentication IndicatorRequired
threeDSRequestorAuthenticationInfo3DS Requestor Authentication InformationOptional
threeDSRequestorChallengeInd3DS Requestor Challenge IndicatorOptional
threeDSRequestorDecMaxTime3DS Requestor Decoupled Max TimeConditional
threeDSRequestorDecReqInd3DS Requestor Decoupled Request IndicatorOptional
threeDSRequestorID3DS Requestor IDRequired
threeDSRequestorName3DS Requestor NameRequired
threeDSRequestorPriorAuthenticationInfo3DS Requestor Prior Transaction Authentication InformationConditional
threeDSRequestorSpcSupport3DS Requestor SPC SupportConditional
threeDSRequestorURL3DS Requestor URLRequired
threeDSServerOperatorID3DS Server Operator IDConditional
threeDSServerRefNumber3DS Server Reference NumberRequired
threeDSServerTransID3DS Server Transaction IDRequired
threeDSServerURL3DS Server URLRequired
threeRIInd3RI IndicatorRequired
transTypeTransaction TypeConditional
trustListStatusTrust List StatusOptional
trustListStatusSourceTrust List Status SourceConditional
userIdBrowser User IDConditional
workPhoneCardholder Work Phone NumberConditional

Source

EMV_3DS_CoreSpec_v2.3.1.1_20230530.pdf · Section 2.4.1, Table B.1

Official EMVCo specifications · Coverage and review limits