Validating a Challenge {#pa2-use-validate-intro} ================================================ Running the Validation service compares the customer's response to the challenge from the issuing bank to validate the customer identity. Card-Specific Requirements {#pa2-use-validate-intro_card-specific-SO} --------------------------------------------------------------------- Some payment cards require additional information to be collected during a transaction. [payerAuthEnrollService_defaultCard](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-default-card.md "") : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_MCC](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-mcc.md "") : This field is required when the card type is Cartes Bancaires. [payerAuthEnrollService_merchantName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-name.md "") : This field is required for Visa Secure travel. [payerAuthEnrollService_productCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-product-code.md "") : This field is required for American Express SafeKey (US) when the product code is `AIR` for an airline purchase). [shipTo_street1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-street1.md "") : This field is required only for American Express SafeKey (US). {#pa2-use-validate-intro_dl_d1v_} [shipTo_street2](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-street2.md "") : This field is required only for American Express SafeKey (US) Country-Specific Requirements {#pa2-use-validate-intro_country-specific-SO} --------------------------------------------------------------------------- These fields are required for transactions in specific countries. [billTo_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-postal-code.md "") : TThis field is required for transactions in the US and Canada. [billTo_postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-postal-code.md "") : This field is required when the billTo_country field value is `US` or `CA`. [billTo_state](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-state.md "") : This field is required for transactions in the US and Canada. [payerAuthEnrollService_merchantScore](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-score.md "") : This field is required for transactions processed in France. {#pa2-use-validate-intro_dl_z_rxb} Endpoint -------- Set the `payerAuthValidateService_run` fields to `true`. Send the request to: **Production:** `https://ics2ws.ic3.com/commerce/1.x/transactionProcessor` **Test:** `https://ics2wstest.ic3.com/commerce/1.x/transactionProcessor` Required Fields for Validating a Challenge {#pa2-use-validation-reqd-fields} ============================================================================ Required Fields --------------- [card_accountNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-account-number.md "") : [card_cardType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-card-type.md "") : [card_expirationMonth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-expiration-month.md "") : This field is required when the card_accountNumber field is included. [card_expirationYear](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-expiration-year.md "") : This field is required when the card_accountNumber field is included. [item_#_unitPrice](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-unit-price.md "") : This field is required when the purchaseTotals_grandTotalAmount field is not used. [merchantReferenceCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-reference-code.md "") : [payerAuthValidateService_authenticationTransactionID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-validate-service-authentication-transac.md "") : payerAuthValidateService_run : [purchaseTotals_currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/purchase-totals-currency.md "") : [purchaseTotals_grandTotalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/purchase-totals-grand-total-amount.md "") : This field is required when the item_#_unitPrice field is not used. 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 "") Optional Fields for Validating a Challenge {#pa-api-validating-optional-fields} =============================================================================== These fields are optional when validating a Payer Authentication transaction. In certain circumstances, the information provided by an optional field might be required before a transaction can proceed. Those optional fields that are sometimes required are listed in the required fields with the circumstance described. [payerAuthValidateReply_authenticationBrand](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-validate-reply-authentication-brand.md "") : This field is used only with mada cards. [payerAuthValidateReply_authorizationPayload](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-validate-reply-authorization-payload.md "") : : [payerAuthValidateService_credentialEncrypted](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-validate-service-credential-encrypted.md "") : [payerAuthValidateService_responseAccessToken](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-validate-service-response-access-token.md "") : [payerAuthValidateService_signedPARes](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-validate-service-signed-pares.md "") : Simple Order Example: Validating a Challenge {#pa2-use-validate-so-ex} ====================================================================== Request ``` merchantID=patest merchantReferenceCode=0001 payerAuthValidateService_authenticationTransactionID=hejNPA0YQlL5gVwZ6OX0 payerAuthValidateService_run=true purchaseTotals_currency=USD purchaseTotals_grandTotalAmount=30.00 ``` Response to Successful Request ``` decision=ACCEPT merchantReferenceCode=0001 payerAuthValidateReply_acsTransactionID=ff412c09-4ea8-4f37-923e-4c405fb3951c payerAuthValidateReply_authenticationResult=0 payerAuthValidateReply_authenticationStatusMessage=Success payerAuthValidateReply_cardBin=40000000 payerAuthValidateReply_cardTypeName=VISA payerAuthValidateReply_cavv=MTIzNDU2Nzg5MDEyMzQ1Njc4OTA= payerAuthValidateReply_commerceIndicator=vbv payerAuthValidateReply_directoryServerTransactionID=6c29615b-1a1e-4c13-9739-0394917163a3 payerAuthValidateReply_eci=05 payerAuthValidateReply_eciRaw=05 payerAuthValidateReply_paresStatus=Y payerAuthValidateReply_reasonCode=100 payerAuthValidateReply_specificationVersion=2.1.0 payerAuthValidateReply_threeDSServerTransactionID=2c2294e9-6b70-4b19-bedb-7b43065f20ce payerAuthValidateReply_xid=MTIzNDU2Nzg5MDEyMzQ1Njc4OTA= reasonCode=100 requestID=6001869286506329603009 ```