On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/payments/developer/ctv/so/payments/payments-processing-pa-process-intro/payments-processing-pa-mc-intro.md)  
Filter  
FILTER BY TAG

Mastercard Identity Check {#payments-processing-pa-mc-intro}
============================================================

Mastercard Identity Check is the authentication service in the Mastercard card network that uses the 3-D Secure protocol in online transactions to authenticate customers at checkout.  
Mastercard Identity Check generates a unique, 32-character transaction token, called the account authentication value (AAV) each time a Mastercard Identity Check-enabled account holder makes an online purchase. The AAV binds the account holder to a specific transaction. Mastercard Identity Check transactions use the universal cardholder authentication field (UCAF) as a standard to collect and pass AAV data.  
Before implementing payer authentication for Mastercard Identity Check, contact customer support to have your account configured for this feature.

Fields Specific to the Mastercard Identity Check Use Case
---------------------------------------------------------

These API fields are required specifically for this use case.

:
Set this field to the transaction ID returned by Mastercard Identity Check during the authentication process.

:
Set this field to the Mastercard Identity Check version returned by Mastercard Identity Check during the authentication process.

ucaf_collectionIndicator
:
Set to the last digit of the raw ECI value returned from authentication. For example, if ECI=02, this value should be 2.

:
Set this field to one of these values:

    * `spa`: Successful authentication (3-D Secure value of `02`).
    * `spa`: Authentication was attempted (3-D Secure value of `01`).
    * `spa` or `internet`: Authentication failed or was not attempted (3-D Secure value of `00`)
    {#payments-processing-pa-mc-intro_ul_a2g_5lz_3xb}

Endpoint {#payments-processing-pa-mc-intro_d7e16}
-------------------------------------------------

Set the ccAuthService_run field to `true`.  
Send the request to `https://ics2ws.ic3.com/commerce/1.x/transactionProcessor`.

Required Fields for Processing an Authorization Using Mastercard Identity Check {#payments-processing-pa-mc-reqfields}
======================================================================================================================

Use these required fields to process an authorization using Mastercard Identity Check.

> When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see [Relaxed Requirements for Address Data and Expiration Date in Payment Transactions](/docs/cybs/en-us/payments/developer/ctv/so/payments/payments-relax-reqs.md "").

billTo_city
:

billTo_country
:

billTo_email
:

billTo_firstName
:

billTo_lastName
:

billTo_postalCode
:

billTo_state
:

billTo_street1
:

card_accountNumber
:

card_expirationMonth
:

card_expirationYear
:

ccAuthService_run
:
Set the value to `true`.

ccAuthService_cavv
:

ccAuthService_commerceIndicator
:
Set this field to one of these values:

    * `spa`: Successful authentication (3-D Secure value of `02`).
    * `spa`: Authentication was attempted (3-D Secure value of `01`).
    * `spa` or `internet`: Authentication failed or was not attempted (3-D Secure value of `00`).
    {#payments-processing-pa-mc-reqfields_ul_a2g_5lz_3xb}

ccAuthService_directoryServerTransactionID
:

ccAuthService_paSpecificationVersion
:

mercahnt_id
:

merchant_referenceCode
:

purchaseTotals_currency
:

purchaseTotals_grandTotalAmount
:

ucaf_collectionIndicator
:
Set to the last digit of the raw ECI value returned from authentication. For example, if ECI=02, this value should be 2.
{#payments-processing-pa-mc-reqfields_dl_pcx_hzz_3xb}

Related Information
-------------------

* [API field reference guide for the Simple Order API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md "")

Simple Order Example: Processing an Authorization Using Mastercard Identity Check {#payments-processing-pa-mc-ex-so}
====================================================================================================================

Request

```keyword
billTo_city=Sao Paulo
billTo_country=BR
billTo_email=null@cybersource.com
billTo_firstname=Julia
billTo_lastname=Fernandez
billTo_postalCode=01310-000
billTo_state=SP
billTo_street1=R. Augusta
card_accountNumber=41111111XXXXXXXX
card_expirationMonth=12
card_expirationYear=2023
ccAuthService_run=true
ccAuthService_cavv=ABCDEFabcdefABCDEFabcdef0987654321234567
ccAuthService_commerceIndicator=spa
ccAuthService_paSpecificationVersion=1
merchant_id=MID23
merchant_referenceCode=Merchant_REF
ucaf_collectionIndicator=1
purchaseTotals_currency=mxn
purchaseTotals_grandTotalAmount=100
```

Response to a Successful Request

```
merchantReferenceCode=Merchant_REF
request_id=6461515866500167772420
decision=ACCEPT
reasonCode=100
purchaseTotals_currency=mxn
ccAuthReply_cardCategory=F
ccAuthService_reconciliationID=ZUDCXJO8KZRFXQJJ
ccAuthReply_reasonCode=100
ccAuthReply_amount=100.00
ccAuthReply_avsCode=5
ccAuthReply_authorizationCode=570110
ccAuthReply_processorResponse=1
ccAuthReply_authorizedDateTime=2022-03-01T161947Z
ccAuthReply_paymentNetworkTransactionID=111222
```

RELATED TO THIS PAGE