You are on page 1of 48

Categories Data Level XiPay Field Name XiPay Field Type

Notes:
Same Field data, logic for all card
types for Worldpay
Mastercard 3DS
MasterCard SecureCode (O) Transaction Level TR_ECOMM_3DSVERSION InfoItem

MasterCard SecureCode (O) Transaction Level TR_ECOMM_IND InfoItem

MasterCard SecureCode (O) Transaction Level TR_ECOMM_PARESSTATUS InfoItem

MasterCard SecureCode (O) Transaction Level TR_ECOMM_VBVCAVV InfoItem


MasterCard SecureCode (O) Transaction Level TR_ECOMM_VBVXID InfoItem
MasterCard SecureCode (O) Transaction Level TR_ECOMM_XID InfoItem

Visa 3DS
Verified by Visa (O) Transaction Level TR_ECOMM_3DSVERSION InfoItem

Verified by Visa (O) Transaction Level TR_ECOMM_IND InfoItem

Verified by Visa (O) Transaction Level TR_ECOMM_PARESSTATUS InfoItem

Verified by Visa (O) Transaction Level TR_ECOMM_VBVCAVV InfoItem


Verified by Visa (O) Transaction Level TR_ECOMM_VBVXID InfoItem
Verified by Visa (O) Transaction Level TR_ECOMM_XID InfoItem

Amex 3DS
American Express SafeKey (O) Transaction Level TR_ECOMM_3DSVERSION InfoItem

American Express SafeKey (O) Transaction Level TR_ECOMM_IND InfoItem

American Express SafeKey (O) Transaction Level TR_ECOMM_PARESSTATUS InfoItem

American Express SafeKey (O) Transaction Level TR_ECOMM_VBVCAVV InfoItem


American Express SafeKey (O) Transaction Level TR_ECOMM_VBVXID InfoItem
American Express SafeKey (O) Transaction Level TR_ECOMM_XID InfoItem

Discover
Discover Protect Buy (O) Transaction Level TR_ECOMM_3DSVERSION InfoItem

Discover Protect Buy (O) Transaction Level TR_ECOMM_IND InfoItem

Discover Protect Buy (O) Transaction Level TR_ECOMM_PARESSTATUS InfoItem

Discover Protect Buy (O) Transaction Level TR_ECOMM_VBVCAVV InfoItem


Discover Protect Buy (O) Transaction Level TR_ECOMM_VBVXID InfoItem
Discover Protect Buy (O) Transaction Level TR_ECOMM_XID InfoItem

JCB
JCB J/Secure (O) Transaction Level TR_ECOMM_3DSVERSION InfoItem

JCB J/Secure (O) Transaction Level TR_ECOMM_IND InfoItem

JCB J/Secure (O) Transaction Level TR_ECOMM_PARESSTATUS InfoItem

JCB J/Secure (O) Transaction Level TR_ECOMM_VBVCAVV InfoItem


JCB J/Secure (O) Transaction Level TR_ECOMM_VBVXID InfoItem
JCB J/Secure (O) Transaction Level TR_ECOMM_XID InfoItem
Not 3DS authenticated
Cardinal Response Field (not a 3DS 3DS1 3DS2
success/attempt)

ThreeDSVersion Do not send 3DS fields Yes Yes

EciFlag Do not send 3DS fields Yes Yes

PAResStatus Do not send 3DS fields Yes Yes

Cavv Do not send 3DS fields Yes Yes


Xid Do not send 3DS fields Yes No (N/A for 3DS2)
DsTransctionID Do not send 3DS fields No (N/A for 3DS1) Yes

ThreeDSVersion Do not send 3DS fields Yes Yes

EciFlag Do not send 3DS fields Yes Yes

PAResStatus Do not send 3DS fields Yes Yes

Cavv Do not send 3DS fields Yes Yes


Xid Do not send 3DS fields Yes No (N/A for 3DS2)
DsTransctionID Do not send 3DS fields No (N/A for 3DS1) Yes

ThreeDSVersion Do not send 3DS fields Yes Yes

EciFlag Do not send 3DS fields Yes Yes

PAResStatus Do not send 3DS fields Yes Yes

Cavv Do not send 3DS fields Yes Yes


Xid Do not send 3DS fields Yes No (N/A for 3DS2)
DsTransctionID Do not send 3DS fields No (N/A for 3DS1) Yes

ThreeDSVersion Do not send 3DS fields Yes Yes

EciFlag Do not send 3DS fields Yes Yes

PAResStatus Do not send 3DS fields Yes Yes

Cavv Do not send 3DS fields Yes Yes


Xid Do not send 3DS fields Yes No (N/A for 3DS2)
DsTransctionID Do not send 3DS fields No (N/A for 3DS1) Yes

ThreeDSVersion Do not send 3DS fields Yes Yes

EciFlag Do not send 3DS fields Yes Yes

PAResStatus Do not send 3DS fields Yes Yes

Cavv Do not send 3DS fields Yes Yes


Xid Do not send 3DS fields Yes No (N/A for 3DS2)
DsTransctionID Do not send 3DS fields No (N/A for 3DS1) Yes
Description Default Field Length

This field is used the identify the 3D secure protocol version used for 10
authentication, example: '1.0.2', '2.1.0'.
The raw ECI data from payer authentication, if you received any for the 255
transaction.
Payer authentication response status received in response to the consumer's 3D 255
secure authentication attempt.
Cardholder authentication verification value (CAVV). 255
Defines the Verified by Visa Transaction Id. 255
Directory Server Transaction ID 36
Generated by the Directory Server during authentication and passed back to the
merchant with the authentication results.

This field is used the identify the 3D secure protocol version used for 10
authentication, example: '1.0.2', '2.1.0'.
The raw ECI data from payer authentication, if you received any for the 255
transaction.
Payer authentication response status received in response to the consumer's 3D 255
secure authentication attempt.
Cardholder authentication verification value (CAVV). 255
Defines the Verified by Visa Transaction Id. 255
Directory Server Transaction ID 36
Generated by the Directory Server during authentication and passed back to the
merchant with the authentication results.

This field is used the identify the 3D secure protocol version used for 10
authentication, example: '1.0.2', '2.1.0'.
The raw ECI data from payer authentication, if you received any for the 255
transaction.
Payer authentication response status received in response to the consumer's 3D 255
secure authentication attempt.
Cardholder authentication verification value (CAVV). 255
Defines the Verified by Visa Transaction Id. 255
Directory Server Transaction ID 36
Generated by the Directory Server during authentication and passed back to the
merchant with the authentication results.

This field is used the identify the 3D secure protocol version used for 10
authentication, example: '1.0.2', '2.1.0'.
The raw ECI data from payer authentication, if you received any for the 255
transaction.
Payer authentication response status received in response to the consumer's 3D 255
secure authentication attempt.
Cardholder authentication verification value (CAVV). 255
Defines the Verified by Visa Transaction Id. 255
Directory Server Transaction ID 36
Generated by the Directory Server during authentication and passed back to the
merchant with the authentication results.

This field is used the identify the 3D secure protocol version used for 10
authentication, example: '1.0.2', '2.1.0'.
The raw ECI data from payer authentication, if you received any for the 255
transaction.
Payer authentication response status received in response to the consumer's 3D 255
secure authentication attempt.
Cardholder authentication verification value (CAVV). 255
Defines the Verified by Visa Transaction Id. 255
Directory Server Transaction ID 36
Generated by the Directory Server during authentication and passed back to the
merchant with the authentication results.
Data Type Merchant(ROC) Integrator Notes

Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional
Alphanumeric Conditional
Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional
Alphanumeric Conditional
Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional
Alphanumeric Conditional
Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional
Alphanumeric Conditional
Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional
Alphanumeric Conditional
Alphanumeric Conditional
Processor Record Name
XiPay
Categories Processor Field Name Data Level XiPay Field Name
Field Type

Notes:

For Visa 3DS2, duplicate Cavv value in TR_ECOMM_VBVXID field, if TR_ECOMM_3DSECUREIND='vbv' (success)

For Mastercard 3DS2, TR_ECOMM_MCSCUCAFIND is not returned, populate numeric value of eciFlag - 1 or 2

TR_ECOMM_3DSVERSION listed below for MC only, but recommended on all card types

Amex 3DS
American Express SafeKey (O) ccAuthService_cavv Transaction TR_ECOMM_VBVCAVV InfoItem
Level

American Express SafeKey (O) ccAuthService_xid Transaction TR_ECOMM_VBVXID InfoItem


Level
American Express SafeKey (R) ccAuthService_commerceIndicator Transaction TR_ECOMM_3DSECUREIND InfoItem
Level

JCB 3DS

JCB J/Secure (O) ccAuthService_cavv Transaction TR_ECOMM_VBVCAVV InfoItem


Level
JCB J/Secure (O) ccAuthService_cavvAlgorithm Transaction TR_ECOMM_ALGORITHM InfoItem
Level
JCB J/Secure (O) ccAuthService_eciRaw Transaction TR_ECOMM_IND InfoItem
Level

JCB J/Secure (O) ccAuthService_paresStatus Transaction TR_ECOMM_PARESSTATUS InfoItem


Level

JCB J/Secure (O) ccAuthService_veresEnrolled Transaction TR_ECOMM_VERESENROLLED InfoItem


Level
JCB J/Secure (O) ccAuthService_xid Transaction TR_ECOMM_VBVXID InfoItem
Level

JCB J/Secure (R) ccAuthService_commerceIndicator Transaction TR_ECOMM_3DSECUREIND InfoItem


Level

Mastercard 3DS

MasterCard SecureCode (O) ccAuthService_paSpecificationVersion Transaction TR_ECOMM_3DSVERSION InfoItem


Level

MasterCard SecureCode (O) ucaf_authenticationData Transaction TR_ECOMM_MCSCUCAF InfoItem


Level

MasterCard SecureCode (O) ccAuthService_directoryServerTransac Transaction TR_ECOMM_XID InfoItem


tionID Level
MasterCard SecureCode (O) ccAuthService_cavvAlgorithm Transaction TR_ECOMM_ALGORITHM InfoItem
Level

MasterCard SecureCode (O) ccAuthService_eciRaw Transaction TR_ECOMM_IND InfoItem


Level

MasterCard SecureCode (O) ccAuthService_paresStatus Transaction TR_ECOMM_PARESSTATUS InfoItem


Level
MasterCard SecureCode (O) ccAuthService_veresEnrolled Transaction TR_ECOMM_VERESENROLLED InfoItem
Level

MasterCard SecureCode (O) ccAuthService_xid Transaction TR_ECOMM_VBVXID InfoItem


Level

MasterCard SecureCode (R) ucaf_collectionIndicator Transaction TR_ECOMM_MCSCUCAFIND InfoItem


Level
MasterCard SecureCode (R) ccAuthService_commerceIndicator Transaction TR_ECOMM_3DSECUREIND InfoItem
Level

Visa
Verified by Visa (O) ccAuthService_cavv Transaction TR_ECOMM_VBVCAVV InfoItem
Level
Verified by Visa (O) ccAuthService_cavvAlgorithm Transaction TR_ECOMM_ALGORITHM InfoItem
Level
Verified by Visa (O) ccAuthService_eciRaw Transaction TR_ECOMM_IND InfoItem
Level

Verified by Visa (O) ccAuthService_paresStatus Transaction TR_ECOMM_PARESSTATUS InfoItem


Level

Verified by Visa (O) ccAuthService_veresEnrolled Transaction TR_ECOMM_VERESENROLLED InfoItem


Level
Verified by Visa (O) ccAuthService_xid Transaction TR_ECOMM_VBVXID InfoItem
Level

Verified by Visa (R) ccAuthService_commerceIndicator Transaction TR_ECOMM_3DSECUREIND InfoItem


Level
Not 3DS
Cardinal
authenticated (not
Response 3DS1 3DS2 Overrides Description
a 3DS
Field
success/attempt)

Cavv Do not send 3DS Yes Yes Cardholder authentication verification value
fields (CAVV).

Xid Do not send 3DS Yes No XID—Transaction identifier. Must be 28-


fields character
base64 or 40-character hex binary.

- Used for all processors that support Visa


Secure, JCB J/Secure.
- For Atos: required for a successful Visa
Secure transaction, which is indicated when
the commerce indicator is vbv.
- For all other processors: required when the
commerce indicator is js, or vbv.
- Optional when the commerce indicator is
js_attempted, or vbv_attempted.
- For Visa Secure on FDC Nashville Global,
CyberSource sets the cardholder authentication
verification value (CAVV) field to the XID value
if the XID is present in the authorization
request and
the CAVV is not present.
For Amex, Do not send 3DS Yes Yes This field can contain one of the following
aesk - if eciFlag fields values:
'05' success • spa: MasterCard SecureCode transaction. If
selected, then ucaf_collectionIndicator is
aesk_attempted required. If authentication is successful,
- if eciFlag '06' ucaf_authenticationData is also required, and
attempt AuthService_xid is optional.
• spa_failure: MasterCard SecureCode
authentication failed. Currently available for
use only with the Streamline processor.
• vbv: Successful Verified by Visa transaction.
If selected, then ccAuthService_cavv and
ccAuthService_xid are required.
• vbv_attempted: Verified by Visa transaction
was attempted but not authenticated. If
selected, then ccAuthService_cavv is required
and ccAuthService_xid is optional.
• vbv_failure: Verified by Visa authentication
failed. Currently available for use only with the
Streamline processor.
• js: Successful JCB J/Secure transaction.
• js_attempted: JCB J/Secure transaction was
attempted but not authenticated.
• aesk: Successful AESK transaction
• aesk_attempted: AESK transaction was
attempted but not authenticated.

Cavv Do not send 3DS Yes Yes Cardholder authentication verification value
fields (CAVV).
CavvAlgorithm Do not send 3DS No No Algorithm used to generate the CAVV for
fields Verified by Visa or the UCAF authentication
data for MasterCard SecureCode.
EciFlag Do not send 3DS Yes Yes The raw ECI data from payer authentication, if
fields you received any for the transaction. Your
processor might require this information to
guarantee chargeback protection. Contact
your processor for information about their
requirements. If you are using the
CyberSource Payer Authentication Services,
use the value that you received from the payer
authentication validation in the
payerAuthValidateReply_eciRaw reply field.

PAResStatus Do not send 3DS Yes Yes Payer authentication response status.
fields
--For Atos: Required for a successful Verified
by Visa transaction
--For the Asia, Middle East, and Africa
Gateway:
Required unless all of the following are true:
-You are requesting the payer
authentication and the authorization in
separate requests.
-This is a successful or attempted Verified
by Visa transaction
-The card is not enrolled, which is indicated
when the VERes enrolled status is not Y.

If all the preceding conditions are true, do


not include the PARes status in the
authorization request. If you do, CyberSource
will send the value to the processor without
modification. CyberSource will not decline the
transaction;
any decline will be generated by the processor.

Enrolled Do not send 3DS No No Verification response enrollment status.


fields --Used only for the Asia, Middle East, and
Africa
Gateway.
Xid Do not send 3DS Yes No (N/A for 3DS2) XID—Transaction identifier. Must be 28-
fields character
base64 or 40-character hex binary.

- Used for all processors that support Visa


Secure, JCB J/Secure.
- For Atos: required for a successful Visa
Secure transaction, which is indicated when
the commerce indicator is vbv.
- For all other processors: required when the
commerce indicator is js, or vbv.
- Optional when the commerce indicator is
js_attempted, or vbv_attempted.
- For Visa Secure on FDC Nashville Global,
CyberSource sets the cardholder authentication
verification value (CAVV) field to the XID value
if the XID is present in the authorization
request and
the CAVV is not present.

For JCB, Do not send 3DS Yes Yes This field can contain one of the following
js - if eciFlag '05' fields values:
success • spa: MasterCard SecureCode transaction. If
js_attempted - if selected, then ucaf_collectionIndicator is
eciFlag '06' required. If authentication is successful,
attempt ucaf_authenticationData is also required, and
AuthService_xid is optional.
• spa_failure: MasterCard SecureCode
authentication failed. Currently available for
use only with the Streamline processor.
• vbv: Successful Verified by Visa transaction.
If selected, then ccAuthService_cavv and
ccAuthService_xid are required.
• vbv_attempted: Verified by Visa transaction
was attempted but not authenticated. If
selected, then ccAuthService_cavv is required
and ccAuthService_xid is optional.
• vbv_failure: Verified by Visa authentication
failed. Currently available for use only with the
Streamline processor.
• js: Successful JCB J/Secure transaction.
• js_attempted: JCB J/Secure transaction was
attempted but not authenticated.
• aesk: Successful AESK transaction
• aesk_attempted: AESK transaction was
attempted but not authenticated.

ThreeDSVersion Do not send 3DS Yes Yes Version of 3D Secure that was used to process
fields the Mastercard Identity Check transaction.
- Always required.
- Examples: 1.0.2 or 2.0.0

Cavv Do not send 3DS Yes Yes UCAF Authentication Data—Authentication data
fields for the universal cardholder authentication
field.
DsTransctionID Do not send 3DS No (N/A not Yes Transaction ID generated by the Mastercard
fields returned for directory server during authentication.
3DS1) - Required for Mastercard Identity Check 2.0
transactions.
CavvAlgorithm Do not send 3DS Yes No (N/A for 3DS2) Algorithm used to generate the CAVV for
fields Verified by Visa or the UCAF authentication
data for MasterCard SecureCode.

EciFlag Do not send 3DS Yes Yes The raw ECI data from payer authentication, if
fields you received any for the transaction. Your
processor might require this information to
guarantee chargeback protection. Contact
your processor for information about their
requirements. If you are using the
CyberSource Payer Authentication Services,
use the value that you received from the payer
authentication validation in the
payerAuthValidateReply_eciRaw reply field.

PAResStatus Do not send 3DS Yes Yes Payer authentication response status.
fields
--For Atos: Required for a successful Verified
by Visa transaction
--For the Asia, Middle East, and Africa
Gateway:
Required unless all of the following are true:
-You are requesting the payer
authentication and the authorization in
separate requests.
-This is a successful or attempted Verified
by Visa transaction
-The card is not enrolled, which is indicated
when the VERes enrolled status is not Y.

If all the preceding conditions are true, do


not include the PARes status in the
authorization request. If you do, CyberSource
will send the value to the processor without
modification. CyberSource will not decline the
transaction;
any decline will be generated by the processor.
Enrolled Do not send 3DS No No Verification response enrollment status.
fields --Used only for the Asia, Middle East, and
Africa
Gateway.

Xid Do not send 3DS Yes No (N/A for 3DS2) XID—Transaction identifier. Must be 28-
fields character
base64 or 40-character hex binary.

- Used for all processors that support Visa


Secure, JCB J/Secure.
- For Atos: required for a successful Visa
Secure transaction, which is indicated when
the commerce indicator is vbv.
- For all other processors: required when the
commerce indicator is js, or vbv.
- Optional when the commerce indicator is
js_attempted, or vbv_attempted.
- For Visa Secure on FDC Nashville Global,
CyberSource sets the cardholder authentication
verification value (CAVV) field to the XID value
if the XID is present in the authorization
request and
the CAVV is not present.

For 3DS1, Do not send 3DS Yes Yes (not returned UCAF Collection Indicator—Collection indicator
UCAFIndicator fields from Cardinal for for
For 3DS2, 3DS2, but expected for the universal cardholder authentication
use numeric in payload to field.
value of eciFlag - CyberSource. Use
1 or 2 numeric value of This field can contain one of the following
eciFlag. '01' - 1 values:
'02 - 2 • 0: UCAF collection is not supported at your
Web site.
• 1: UCAF collection is supported at your web
site and UCAF might have been populated
• 2: UCAF collection is supported, and UCAF
was populated. Successful MasterCard
SecureCode transaction.
For MC, Do not send 3DS Yes Yes This field can contain one of the following
spa- if eciFlag fields values:
'02' success • spa: MasterCard SecureCode transaction. If
selected, then ucaf_collectionIndicator is
spa_attempted - required. If authentication is successful,
if eciFlag '01' ucaf_authenticationData is also required, and
attempt AuthService_xid is optional.
• spa_failure: MasterCard SecureCode
authentication failed. Currently available for
use only with the Streamline processor.
• vbv: Successful Verified by Visa transaction.
If selected, then ccAuthService_cavv and
ccAuthService_xid are required.
• vbv_attempted: Verified by Visa transaction
was attempted but not authenticated. If
selected, then ccAuthService_cavv is required
and ccAuthService_xid is optional.
• vbv_failure: Verified by Visa authentication
failed. Currently available for use only with the
Streamline processor.
• js: Successful JCB J/Secure transaction.
• js_attempted: JCB J/Secure transaction was
attempted but not authenticated.
• aesk: Successful AESK transaction
• aesk_attempted: AESK transaction was
attempted but not authenticated.

Cavv Do not send 3DS Yes Yes Cardholder authentication verification value
fields (CAVV).
CavvAlgorithm Do not send 3DS No No Algorithm used to generate the CAVV for
fields Verified by Visa or the UCAF authentication
data for MasterCard SecureCode.
EciFlag Do not send 3DS Yes Yes The raw ECI data from payer authentication, if
fields you received any for the transaction. Your
processor might require this information to
guarantee chargeback protection. Contact
your processor for information about their
requirements. If you are using the
CyberSource Payer Authentication Services,
use the value that you received from the payer
authentication validation in the
payerAuthValidateReply_eciRaw reply field.

PAResStatus Do not send 3DS Yes Yes Payer authentication response status.
fields
--For Atos: Required for a successful Verified
by Visa transaction
--For the Asia, Middle East, and Africa
Gateway:
Required unless all of the following are true:
-You are requesting the payer
authentication and the authorization in
separate requests.
-This is a successful or attempted Verified
by Visa transaction
-The card is not enrolled, which is indicated
when the VERes enrolled status is not Y.

If all the preceding conditions are true, do


not include the PARes status in the
authorization request. If you do, CyberSource
will send the value to the processor without
modification. CyberSource will not decline the
transaction;
any decline will be generated by the processor.

Enrolled Do not send 3DS No No Verification response enrollment status.


fields --Used only for the Asia, Middle East, and
Africa
Gateway.
For Visa, Do not send 3DS Yes Yes (conditional) XID—Transaction identifier. Must be 28-
Xid if 3DS1 fields Field not returned character
Cavv if 3DS2, for 3DS2, however base64 or 40-character hex binary.
but only if 'vbv' CyberSource requires
(success), else this value to be - Used for all processors that support Visa
don't send for populated for Visa Secure, JCB J/Secure.
3DS2 when - For Atos: required for a successful Visa
TR_ECOMM_3DSECU Secure transaction, which is indicated when
REIND = 'vbv'. the commerce indicator is vbv.
Duplicate cavv - For all other processors: required when the
value in this field for commerce indicator is js, or vbv.
3DS2, when - Optional when the commerce indicator is
3DSECUREIND = js_attempted, or vbv_attempted.
'vbv'. Don't send - For Visa Secure on FDC Nashville Global,
field , if not 'vbv' and CyberSource sets the cardholder authentication
3DS2 is version verification value (CAVV) field to the XID value
if the XID is present in the authorization
request and
the CAVV is not present.

For Visa, Do not send 3DS Yes Yes This field can contain one of the following
vbv- if eciFlag fields values:
'05' success • spa: MasterCard SecureCode transaction. If
selected, then ucaf_collectionIndicator is
vbv_attempted - required. If authentication is successful,
if eciFlag '06' ucaf_authenticationData is also required, and
attempt AuthService_xid is optional.
• spa_failure: MasterCard SecureCode
authentication failed. Currently available for
use only with the Streamline processor.
• vbv: Successful Verified by Visa transaction.
If selected, then ccAuthService_cavv and
ccAuthService_xid are required.
• vbv_attempted: Verified by Visa transaction
was attempted but not authenticated. If
selected, then ccAuthService_cavv is required
and ccAuthService_xid is optional.
• vbv_failure: Verified by Visa authentication
failed. Currently available for use only with the
Streamline processor.
• js: Successful JCB J/Secure transaction.
• js_attempted: JCB J/Secure transaction was
attempted but not authenticated.
• aesk: Successful AESK transaction
• aesk_attempted: AESK transaction was
attempted but not authenticated.
Processor
Field Merchant(
Default Data Type Integrator Notes Record
Length ROC)
Name

40 Alphanumeri Conditional
c

40 Alphanumeri Conditional
c
13 Alphanumeri Conditional Required for :
c - Verified by Visa
- JCB J/Secure
- MasterCard
SecureCode
- American Express
Safekey

40 Alphanumeri Conditional
c
1 Alphanumeri Conditional --Used only for Atos.
c --Required when you
include the CAVV in
your
request.
--You must not include
the CAVV algorithm
value in
your request if the
CAVV is not included in
your
request or if you are
not using Atos.
--Possible values:
0: HMAC (hash-based
message
authentication code)
1: CVV
2: CVV with ATN
3: MasterCard SPA
(secure payment
algorithm)
2 Alphanumeri Conditional
c

1 Alphanumeri Conditional Possible values:


c  Y: Customer was
successfully
authenticated.
 A: Proof of
authentication attempt
was generated.
 N: Customer failed
or cancelled
authentication.
Transaction denied.
 U: Authentication
not completed
regardless of the
reason.

1 String Conditional Possible values:


 Y: Authentication
available.
 N: Cardholder not
participating.
 U: Unable to
authenticate regardless
of the reason.
40 Alphanumeri Conditional
c

13 Alphanumeri Conditional Required for :


c - Verified by Visa
- JCB J/Secure
- MasterCard
SecureCode
- American Express
Safekey

5 Alphanumeri Conditional
c

32 Alphanumeri Conditional
c

36 Alphanumeri Conditional
c
1 Alphanumeri Conditional --Used only for Atos.
c --Required when you
include the CAVV in
your
request.
--You must not include
the CAVV algorithm
value in
your request if the
CAVV is not included in
your
request or if you are
not using Atos.
--Possible values:
0: HMAC (hash-based
message
authentication code)
1: CVV
2: CVV with ATN
3: MasterCard SPA
(secure payment
algorithm)

2 Alphanumeri Conditional
c

1 Alphanumeri Conditional Possible values:


c  Y: Customer was
successfully
authenticated.
 A: Proof of
authentication attempt
was generated.
 N: Customer failed
or cancelled
authentication.
Transaction denied.
 U: Authentication
not completed
regardless of the
reason.
1 String Conditional Possible values:
 Y: Authentication
available.
 N: Cardholder not
participating.
 U: Unable to
authenticate regardless
of the reason.

40 Alphanumeri Conditional
c

1 Alphanumeri Conditional
c
13 Alphanumeri Conditional Required for :
c - Verified by Visa
- JCB J/Secure
- MasterCard
SecureCode
- American Express
Safekey

40 Alphanumeri Conditional
c
1 Alphanumeri Conditional --Used only for Atos.
c --Required when you
include the CAVV in
your
request.
--You must not include
the CAVV algorithm
value in
your request if the
CAVV is not included in
your
request or if you are
not using Atos.
--Possible values:
0: HMAC (hash-based
message
authentication code)
1: CVV
2: CVV with ATN
3: MasterCard SPA
(secure payment
algorithm)
2 Alphanumeri Conditional
c

1 Alphanumeri Conditional Possible values:


c  Y: Customer was
successfully
authenticated.
 A: Proof of
authentication attempt
was generated.
 N: Customer failed
or cancelled
authentication.
Transaction denied.
 U: Authentication
not completed
regardless of the
reason.

1 String Conditional Possible values:


 Y: Authentication
available.
 N: Cardholder not
participating.
 U: Unable to
authenticate regardless
of the reason.
40 Alphanumeri Conditional
c

13 Alphanumeri Conditional Required for :


c - Verified by Visa
- JCB J/Secure
- MasterCard
SecureCode
- American Express
Safekey
Categories Processor Field Name Data Level XiPay Field Name

Notes:

TR_TRANS_TYPE (ecom override, needs to be updated if success or attempt for 3DS, otherwise 7).

TR_ECOMM_3DSVERSION listed below for MC only, but recommended on all card types

General Fields Related to 3DS (all cards)

00-General Authorization Request Transaction Type Transaction Level TRANS TYPE

Amex 3DS (not listed in Mappings, but I


believe is supported from recent platform
changes, should be similar to Visa, except
Xid may come back for Amex and 3DS2)

Mastercard 3DS
MasterCard SecureCode (R) Program Protocol Transaction Level TR_ECOMM_3DSVERSION

MasterCard SecureCode (R) UCAF Collection Indicator Transaction Level TR_ECOMM_IND

MasterCard SecureCode (R) Accountholder Authentication Transaction Level TR_ECOMM_MCSCUCAF


Value (AAV)

MasterCard SecureCode (R) Directory Server Transaction Transaction Level TR_ECOMM_XID


ID

Visa 3DS
Verified by Visa (R) Cardholder Authentication Transaction Level TR_ECOMM_VBVCAVV
Verification Value (CAVV)

Verified by Visa (R) Transaction ID (XID) Transaction Level TR_ECOMM_VBVXID


Not 3DS authenticated
XiPay
Cardinal Response Field (not a 3DS 3DS1 3DS2
Field Type
success/attempt)

Config TR_TRANS_TYPE (override for Yes (7, if not 3DS Yes (5 or 6 based Yes (5 or 6 based
ECOM transactions) success/attempted, eci on EciFlag, 02 or on EciFlag, 02 or
flag=00, 07 or not present) 05=5 and 01 or 05=5 and 01 or
06=6) 06=6)
InfoItem ThreeDSVersion ( 1 or 2, not full Do not send 3DS fields Yes Yes
version)

InfoItem EciFlag (numeric value, 1 char. Do not send 3DS fields Yes Yes
only, i.e 1, 2, etc.)

InfoItem Cavv Do not send 3DS fields Yes Yes

InfoItem DSTransactionID Do not send 3DS fields No (N/A not Yes


returned for
3DS1)
InfoItem Cavv Do not send 3DS fields Yes Yes

InfoItem Xid Do not send 3DS fields Yes No, (N/A for
3DS2)
Merchant(
Overrides Description Default Field Length Data Type
ROC)

TR_TRANS_TYPE (1)-(I) Describes the circumstances under Merchant should only 1


which the transaction takes place. provide a value in infoitem
TR_TRANS_TYPE if they
Note: Merchant should never wish to override the value
provide infoitem TR_TRANS_TYPE provided in the
for merchant initiated recurring configuration setting
transactions (TR_TRANS_MSGTYPE TRANS TYPE or if it is a
= MREC) as these transactions will merchant initiated
always be designated as Recurring. transaction
(TR_TRANS_MSGTYPE =
MREC).

Allowed values:
R - Retail indicator -
designates a transaction
where the cardholder was
present at a merchant
location.
1 - MOTO indicator - Single
transaction mail/telephone
order. Designates a
transactions where the
cardholder is not present
at a merchant location and
consummates the sale via
the phone or through the
mail.
5 - ECI indicator - Secure
Electronic Commerce
Transaction: designates a
transaction consummated
via the Internet at a 3-D
Secure capable and the
cardholder is fully
authenticated (e.g. 3-D
Secure includes Verified by
Visa and MasterCard
SecureCode)
6- ECI Indicator - Non-
Authenticated Electronic
Commerce Transaction:
designates a transaction
consummated via the
Internet at a 3-D Secure
capable merchant that
attempted to authenticate
the cardholder using 3-D
Secure. (e.g. 3-D Secure
includes Verified by Visa
and MasterCard
SecureCode) Attempts
occur with Verified by Visa
and MasterCard
Version of 3D Secure that was used This field is used the 1
to process the Mastercard Identity identify the 3D secure
Check transaction. protocol version used for
- Always required. authentication.
- Examples: 1.0.2 or 2.0.0
'1' = 3DS 1.0
'2' = 3DS 2.0
UCAF Authentication Data— Indicates merchant 1
Authentication data for the support of the Universal
universal cardholder authentication Cardholder Authentication
field. Field (UCAF).
Valid Values:
0 – Merchant does not
support or opted not to
send UCAF
1 – Attempted
authentication data
present
2 – Full authentication data
present 3 – Static
authentication data
present 4 – Not
authenticated, Data Only
call.
5 – Issuer Risk Based
Decisioning
6 – Merchant Risk Based
Decisioning or Merchant
MDES token
7 – Partial Shipment or
Recurring Payment

Transaction ID generated by the Unique transaction token 32


Mastercard directory server during generated by the Issuer
authentication. and presented to the
- Required for Mastercard Identity merchant each time a
Check 2.0 transactions. cardholder conducts an
electronic transaction using
MasterCard SecureCode.

Must be sent using Base


64 Encoding. This is the
same format used by
MasterCard when returning
the AAV data to the
merchant during the
authentication step.

Algorithm used to generate the Directory Server 36


CAVV for Verified by Visa or the Transaction ID
UCAF authentication data for Generated by the Directory
MasterCard SecureCode. Server during
authentication and passed
back to the merchant with
the authentication results.
A cryptographic value derived (Base 40 Alphanumeri Conditional
64 Encoded) with an algorithm that c
applies the issuer’s private key to
the combination of the Cardholder
Account number, the Transaction
Identifier (XID), and other data.

Unique tracking number set by the 40 Alphanumeri Conditional


merchant and sent to the Issuer c
Authentication/Service in the
Authentication Request message.
Processor
Integrator Notes Record
Name

Alphanumeric Optional
Alphanumeric Conditional

Numeric Conditional

Alphanumeric Conditional

Alphanumeric Conditional
Visa
Authenticati
on Format
Indicator

Must be sent for Verified by Visa


Visa Authenticati
on Format
Indicator

You might also like