Validating and Authorizing a Transaction {#pa2-use-validate-auth-intro} ======================================================================= 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](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/cc-auth-service-commerce-indicator.md "") : 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](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/cc-auth-service-cavv-a.md "") : 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](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_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. [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. [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). [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). {#pa2-use-validate-auth-intro_dl_d1v_trz_rxb} Country-Specific Requirements ----------------------------- These fields are required for transactions in specific countries. [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. [billTo_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-postal-code.md "") : This 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. {#pa2-use-validate-auth-intro_dl_gpf_5rz_rxb} Endpoint -------- Set the `payerAuthValidateService_run` and `ccAuthService_run` fields to `true`. Send the request to `https://ics2ws.ic3.com/commerce/1.x/transactionProcessor`. Required Fields for Processing an Authorization Using Visa Secure {#payments-processing-pa-visa-reqfields} ========================================================================================================== > 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 a Payment](/docs/cybs/en-us/payer-authentication/developer/all/so/payer-auth/payments-relax-reqs.md ""). Required Fields --------------- billTo_city : billTo_country : billTo_email : billTo_firstName : billTo_lastName : billTo_postalCode : billTo_state : billTo_street1 : card_accountNumber : card_expirationMonth : card_expirationYear : ccAuthService_cavv : This field is required when payer authentication is successful. Otherwise, this field is optional. ccAuthService_commerceIndicator : Set the value of this field to one of these values: * `vbv`: Successful authentication (EMV `3-D Secure` value of `05`). * `vbv_attempted`: Authentication was attempted (EMV `3-D Secure` value of `06`). * `vbv_failure`: or `internet`: Authentication failed or was not attempted (EMV `3-D Secure` value of `07`) {#payments-processing-pa-visa-reqfields_ul_kx5_plz_3xb} ccAuthService_run : Set the value of this field to `true`. ccAuthService_xid : merchant_referenceCode : purchaseTotals_currency : purchaseTotals_grandTotalAmount : Simple Order Example: Validating and Authorizing an Authorization {#payments-processing-pa-visa-ex-so} ====================================================================================================== Request ``` billTo_city=Sao Paulo billTo_country=BR billTo_email=julia@email.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=vbv ccAuthService_xid=MID23 merchant_referenceCode=Merchant_REF 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 ```