Pre-Authorization {#payments-processing-pre-auth-intro}
=======================================================

This section provides the information you need in order to process a pre-authorization.  
A pre-authorization enables you to authorize a payment when the final amount is unknown. The system places the funds on hold until you request a follow-up transaction. Pre-authorizations are typically used for lodging, auto rental, e-commerce, and restaurant transactions.
Payment Services Directive 2 (PSD2) rules in the European Union (EU) and European Economic Area (EEA) require the initial pre-authorization to use strong customer authentication for merchants or customers in PSD2-applicable countries.  
When you have a specific merchant category code (MCC) assigned to your account, you are allowed to capture up to 20% more than the cumulatively authorized amount on Visa, Diners Club, Discover, and JCB cards. Contact your account manager to have your account enabled for this option.  
For a pre-authorization:

* The authorization amount is greater than zero.
* Submit the authorization for capture within 30 calendar days of its request.
* When you do not capture the authorization, reverse it.  
  In the US, Canada, Latin America, and Asia Pacific, Mastercard charges an additional fee for a pre-authorization that is not captured and not reversed.  
  In Europe, Russia, Middle East, and Africa, Mastercard charges fees for all pre-authorizations.
* Chargeback protection is in effect for 30 days after the authorization.
  All supported card types can process pre-authorizations.

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

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

Required Fields for a Pre-Authorization {#payments-processing-pre-auth-required}
================================================================================

Use these required fields for processing a pre-authorization.

authIndicator
:
Set the value to `0`.

billTo_city
:

billTo_country
:

billTo_email
:

billTo_firstName
:

billTo_lastName
:

billTo_postalCode
:

billTo_state
:

billTo_street1
:

card_accountNumber
:

card_cardType
:

card_expirationMonth
:

card_expirationYear
:

ccAuthService_run
:
Set the value to `true`.

merchantID
:

merchantReferenceCode
:

purchaseTotals_currency
:

purchaseTotals_grandTotalAmount
:

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

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

Argentina
---------

billTo_merchantTaxID
:
Required for Mastercard transactions.
{#payments-processing-pre-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 Pre-Authorization {#payments-processing-pre-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
authIndicator=0
```

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