Basic Authorization {#payments-processing-basic-auth-intro}
===========================================================

This section provides the information you need in order to process a basic authorization.
All supported card types can process authorizations.

Endpoint {#payments-processing-basic-auth-intro_d7e16}
------------------------------------------------------

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

Declined Authorization {#payments-intro-processing-auth-decline}
================================================================

If an authorization is declined, you can use response categories to help you decide whether to retry or block a declined transaction. These response fields provide additional information:

* ccAuthReply_paymentInsightsInformation_responseInsightsCategory
* ccAuthReply_paymentInsightsInformation_responseInsightsCategoryCode  
  These fields are available starting in the XML schema version 1.193.

Category codes have possible values (such as `01`) each of which corresponds to a category that contains a description.  
You cannot retry this category code and category:

* `01 ISSUER_WILL_NEVER_APPROVE`

{#payments-intro-processing-auth-decline_ul_wxl_1yx_f5b}For these values, you can retry the transaction a maximum of 15 times over a period of 30 days:


* `02 ISSUER_CANNOT_APPROVE_AT_THIS_TIME`
* `03 ISSUER_CANNOT_APPROVE_WITH_THESE_DETAILS`: Data quality issue. Revalidate data prior to retrying the transaction.
* `04 GENERIC_ERROR`
* `97 PAYMENT_INSIGHTS_INTERNAL_ERROR`
* `98 OTHERS`
* `99 PAYMENT_INSIGHTS_RESPONSE_CATEGORY_MATCH_NOT_FOUND`
  {#payments-intro-processing-auth-decline_ul_zf4_4yx_f5b}

Required Fields for Processing a Basic Authorization {#payments-processing-basic-auth-required}
===============================================================================================

> 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/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`.

merchantID
:

merchantReferenceCode
:

purchaseTotals_currency
:

purchaseTotals_grandTotalAmount
:

Country-Specific Required Fields for Processing a Basic Authorization {#payments-processing-basic-auth-required-country}
========================================================================================================================

Use these country-specific required fields to process a basic authorization.

Argentina
---------

billTo_merchantTaxID
:
Required for Mastercard transactions.
{#payments-processing-basic-auth-required-country_taxID}

transactionLocalDateTime
:
Required in Argentina when the time zone is not included in your account. Otherwise, this field is optional.

Brazil
------

billTo_personalID
:
Required for combo card transactions.

ccAuthService_overridePaymentDetails
:
Required for combo card line-of-credit and prepaid-card transactions.

Chile
-----

billTo_merchantTaxID
:
Required for Mastercard transactions.

Egypt
-----

card_cardType
:
Required for Meeza transactions. Set the value to `067`.

invoiceHeader_merchantDescriptorCountry
:
Required for Meeza transactions. Set the value to `EG`.

Paraguay
--------

billTo_merchantTaxID
:
Required for Mastercard transactions.

Saudi Arabia
------------

transactionMode
:
Required only for merchants in Saudi Arabia.

Taiwan
------

Name: card_hashedAccountNumber
:
Required only for merchants in Taiwan.

Simple Order Example: Processing a Basic Authorization {#payments-processing-basic-auth-ex-so}
==============================================================================================

Request

```keyword
billTo_city=Ann Arbor
billTo_country=US
billTo_email=null@cybersource.com
billTo_firstname=John
billTo_lastname=Smith
billTo_postalCode=48104-2201
billTo_state=MI
billTo_street1=201 S. Division St.
card_accountNumber=41111111XXXXXXXX
card_expirationMonth=12
card_expirationYear=2023
ccAuthService_run=true
merchant_id=npr_paymentech
merchant_referenceCode=TC42703-1
purchaseTotals_currency=usd
purchaseTotals_grandTotalAmount=100
```

Response to a Successful Request

```
requestID=6629977932421985593067
decision=ACCEPT
reasonCode=100
merchantReferenceCode=TC42703-1
purchaseTotals_currency=usd
ccAuthService_reconciliationID=57953165A7YFPS77
ccAuthReply_amount=100.00
ccAuthReply_avsCode=5
ccAuthReply_authorizationCode=570110
ccAuthReply_processorResponse=1
ccAuthReply_authorizedDateTime=2022-09-12T154953Z
ccAuthReply_paymentNetworkTransactionID=123456789619999
```

Response to a Declined Request

```
requestID=6629977932421985593067
merchantReferenceCode=Merchant_REF
decision=REJECT
ccAuthReply_avsCode=Y
ccAuthReply_avsCodeRaw=Y
ccAuthReply_paymentNetworkTransactionID=111222
ccAuthReply_transactionID=111222
ccAuthReply_paymentInsightsInformation_responseInsightsCategory=
    ISSUER_CANNOT_APPROVE_WITH_THESE_DETAILS
ccAuthReply_paymentInsightsInformation_responseInsightsCategoryCode=03
ccAuthReply_processorResponse=183  
ccAuthReply_reasonCode=233
```