Requesting the Check Enrollment Service (SDK)

After the SDK completes the device collection from your mobile application, and after the customer clicks the Buy button, you must make a back-end, server-to-server call to request the Enrollment Check service.

The Check Enrollment service verifies that the card is enrolled in a card authentication program. The merchant ID is included as part of the header, but these fields are required in the request:

clientReferenceInformation.code

consumerAuthenticationInformation.referenceId

orderInformation.amountDetails.currency

orderInformation.amountDetails.totalAmount

orderInformation.billTo.address1

orderInformation.billTo.administrativeArea

orderInformation.billTo.country

orderInformation.billTo.email

orderInformation.billTo.firstName

orderInformation.billTo.lastName

orderInformation.billTo.locality

orderInformation.billTo.postalCode

paymentInformation.card.expirationMonth

paymentInformation.card.expirationYear

paymentInformation.card.number

paymentInformation.card.type

IMPORTANT

To reduce your issuer step-up authentication rates, you can send additional request data in order. It is best to send all available fields.

Use the enrollment check and card authorization services in the same request or in separate requests:

Same request:

Cybersource

attempts to authorize the card if your customer is not enrolled in a payer authentication program. In this case, the field values that are required to prove that you attempted to check enrollment are passed automatically to the authorization service. If authentication is required, processing automatically stops.

Separate requests: Manually include the enrollment check result values (Enrollment Check response fields) in the authorization service request (Card Authorization request fields).

Be sure to include the following card-specific information in your authorization request:

For Visa, American Express, JCB, Diners Club, Discover, China UnionPay, and Elo, include the CAVV.

For Mastercard only, include the collection indicator and the AAV (also known as UCAF).

These fields are listed in this table.

Enrollment Check and Response Fields
Identifier	Enrollment Check Response Field	Card Authorization Request Field
E-commerce indicator	consumerAuthenticationInfo rmation.ecommerceIndicator	processingInformation.commerceIndicator
Collection indicator	consumerAuthenticationInfo rmation.ucafCollectionIndicator	consumerAuthenticationInfo rmation.ucafCollectionIndicator
CAVV	consumerAuthenticationInfo rmation.cavv	consumerAuthenticationInfo rmation.cavv
AAV	consumerAuthenticationInfo rmation.ucafAuthentication Data	consumerAuthenticationInfo rmation.ucafAuthentication Data
XID	consumerAuthenticationInfo rmation.xid and	consumerAuthenticationInfo rmation.xid
Result of the enrollment check for Asia, Middle East, and Africa Gateway	consumerAuthenticationInfo rmation.veresEnrolled	consumerAuthenticationInfo rmation.veresEnrolled
3-D Secure version	consumerAuthenticationInfo rmation.specificationVersion	consumerAuthenticationInfo rmation.paSpecificationVersion
Directory server transaction ID (Not required for 3-D Secure 1.0.)	consumerAuthenticationInfo rmation.directoryServerTran sactionId	consumerAuthenticationInfo rmation.directoryServerTransactionId