Validating and Authorizing a Transaction

The Validation service can be combined with the Authorization service so that when a customer's authentication is validated, the transaction is automatically submitted for authorization.

Fields Specific to a Visa Secure Transaction

These API fields are required specifically for this use case.
ccAuthService_commerceIndicator
Set this field to
vbv
for a successful authentication (EMV 3-D Secure value of
05
),
vbv_attempted
if authentication was attempted but did not succeed (EMV 3-D Secure value of
06
), or
vbv_failure
if authentication failed (EMV 3-D Secure value of
07
).
ccAuthService_cavv
This field is required when payer authentication is successful.

Card-Specific Requirements

Some payment cards require information to be collected during a transaction.
payerAuthEnrollService_defaultCard
This field is recommended for Discover ProtectBuy.
payerAuthEnrollService_MCC
This field is required when the card type is Cartes Bancaires.
payerAuthEnrollService_productCode
This field is required for American Express SafeKey (US) when the product code is
AIR
for an airline purchase.
payerAuthEnrollService_merchantName
This field is required for Visa Secure travel.
shipTo_street1
This field is required only for American Express SafeKey (US).
shipTo_street2
This field is required only for American Express SafeKey (US).

Country-Specific Requirements

These fields are required for transactions in specific countries.
consumerAuthenticationInformation. merchantScore
This field is required for transactions processed in France.
billTo_city
This field is required for transactions in the US and Canada.
billTo_postalCode
This field is required when the
billTo_country
field value is
US
or
CA
.
billTo_state
This field is required for transactions in the US and Canada.

Endpoint

Set the
payerAuthValidateService_run
and
ccAuthService_run
fields to
true
.
Send the request to
https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
.