3-D Secure error handling

DOCS

Last updated: Aug 15th, 7:19am

Error handling information for 3-D Secure API calls.

Create recurring payments profile

NVP

Field	Description
`AUTHSTATUS3DS`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `PAResStatus` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`MPIVENDOR3DS`	(Optional) A value returned by CardinalCommerce. Set this field to the `Enrolled` value returned by `cmpi_lookup`.
`CAVV`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Cavv` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`ECI3DS`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `EciFlag` value returned by `cmpi_authenticate`. Otherwise, set this field to the `EciFlag` value returned by `cmpi_lookup`.
`XID`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Xid` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`THREEDSVERSION`	This field is for 3-D Secure 2.0. Contains the 3DS version that was used to process the transaction. Possible values: 1.0.2 2.1.0 2.2.0 Note: Required for Mastercard Identity Check transaction in Authorization.
`DSTRANSACTIONID`	This field is for 3-D Secure 2.0. Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction. Note: Required for Mastercard Identity Check transaction in Authorization. Available only in EMV 3DS (3DS 2.0) transactions.

SOAP

Field	Description
`AuthStatus3ds`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `PAResStatus` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`MpiVendor3ds`	`xs:string` (Optional) A value returned by CardinalCommerce. Set this field to the `Enrolled` value returned by `cmpi_lookup`.
`Cavv`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Cavv` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`Eci3ds`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `EciFlag` value returned by `cmpi_authenticate`. Otherwise, set this field to the `EciFlag` value returned by `cmpi_lookup`.
`Xid`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Xid` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`ThreeDSVersion`	This field is for 3-D Secure 2.0. Contains the 3DS version that was used to process the transaction. Possible values: 1.0.2 2.1.0 2.2.0 Note: Required for Mastercard Identity Check transaction in Authorization.
`DSTransactionId`	This field is for 3-D Secure 2.0. Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction. Note: Required for Mastercard Identity Check transaction in Authorization. Available only in EMV 3DS (3DS 2.0) transactions.

Do Direct Payment

NVP

Field	Description
`AUTHSTATUS3DS`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `PAResStatus` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`MPIVENDOR3DS`	(Optional) A value returned by CardinalCommerce. Set this field to the `Enrolled` value returned by `cmpi_lookup`.
`CAVV`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Cavv` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`ECI3DS`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `EciFlag` value returned by `cmpi_authenticate`. Otherwise, set this field to the `EciFlag` value returned by `cmpi_lookup`.
`XID`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Xid` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`THREEDSVERSION`	This field is for 3-D Secure 2.0. Contains the 3DS version that was used to process the transaction. Possible values: 1.0.2 2.1.0 2.2.0 Note: Required for Mastercard Identity Check transaction in Authorization.
`DSTRANSACTIONID`	This field is for 3-D Secure 2.0. Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction. Note: Required for Mastercard Identity Check transaction in Authorization. Available only in EMV 3DS (3DS 2.0) transactions.

SOAP

Field	Description
`AuthStatus3ds`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `PAResStatus` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`MpiVendor3ds`	`xs:string` (Optional) A value returned by CardinalCommerce. Set this field to the `Enrolled` value returned by `cmpi_lookup`.
`Cavv`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Cavv` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`Eci3ds`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `EciFlag` value returned by `cmpi_authenticate`. Otherwise, set this field to the `EciFlag` value returned by `cmpi_lookup`.
`Xid`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Xid` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`ThreeDSVersion`	This field is for 3-D Secure 2.0. Contains the 3DS version that was used to process the transaction. Possible values: 1.0.2 2.1.0 2.2.0 Note: Required for Mastercard Identity Check transaction in Authorization.
`DSTransactionId`	This field is for 3-D Secure 2.0. Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction. Note: Required for Mastercard Identity Check transaction in Authorization. Available only in EMV 3DS (3DS 2.0) transactions.

Update recurring payments profile

NVP

Field	Description
`AUTHSTATUS3DS`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `PAResStatus` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`MPIVENDOR3DS`	(Optional) A value returned by CardinalCommerce. Set this field to the `Enrolled` value returned by `cmpi_lookup`.
`CAVV`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Cavv` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`ECI3DS`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `EciFlag` value returned by `cmpi_authenticate`. Otherwise, set this field to the `EciFlag` value returned by `cmpi_lookup`.
`XID`	(Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Xid` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`THREEDSVERSION`	This field is for 3-D Secure 2.0. Contains the 3DS version that was used to process the transaction. Possible values: 1.0.2 2.1.0 2.2.0 Note: Required for Mastercard Identity Check transaction in Authorization.
`DSTRANSACTIONID`	This field is for 3-D Secure 2.0. Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction. Note: Required for Mastercard Identity Check transaction in Authorization. Available only in EMV 3DS (3DS 2.0) transactions.

SOAP

Field	Description
`AuthStatus3ds`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `PAResStatus` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`MpiVendor3ds`	`xs:string` (Optional) A value returned by CardinalCommerce. Set this field to the `Enrolled` value returned by `cmpi_lookup`.
`Cavv`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Cavv` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`Eci3ds`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `EciFlag` value returned by `cmpi_authenticate`. Otherwise, set this field to the `EciFlag` value returned by `cmpi_lookup`.
`Xid`	`xs:string` (Optional) A value returned by CardinalCommerce. If the `cmpi_lookup` request returns `Y` for `Enrolled`, set this field to the `Xid` value returned by `cmpi_authenticate`. Otherwise, set this field to blank.
`ThreeDSVersion`	This field is for 3-D Secure 2.0. Contains the 3DS version that was used to process the transaction. Possible values: 1.0.2 2.1.0 2.2.0 Note: Required for Mastercard Identity Check transaction in Authorization.
`DSTransactionId`	This field is for 3-D Secure 2.0. Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction. Note: Required for Mastercard Identity Check transaction in Authorization. Available only in EMV 3DS (3DS 2.0) transactions.

Error codes

Code	Component	Messages
12000	`DoDirectPayment`	SHORT	Transaction is not compliant due to missing or invalid 3-D Secure authentication values.
LONG	Transaction is not compliant due to missing or invalid 3-D Secure authentication values.
Note: Check `ECI`, `ECI3DS`, `CAVV`, and `XID` fields. In addition to missing or invalid values, this error is returned if you execute a direct payment transaction for a Maestro card without authenticating using 3-D Secure.
12001	`DoDirectPayment`	SHORT	Transaction is not compliant due to missing or invalid 3-D Secure authentication values.
LONG	Transaction is not compliant due to missing or invalid 3-D Secure authentication values.
Note: Check `ECI`, `ECI3DS`, `CAVV`, and `XID` fields.
12002	`DoDirectPayment`	SHORT	Processor Decline.
LONG	This transaction cannot be processed due to either missing, incomplete or invalid 3-D Secure authentication values.
Note: The transaction was declined by the issuing bank because missing/incomplete/invalid 3-D Secure (3DS) authentication information. Perform 3DS authentication, receive the 3DS values from authentication, and then pass those values in the `DoDirectPayment` call.