Pre-Authorizations

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. It is typically used for lodging, auto rental, e-commerce, and restaurant transactions.
For a pre-authorization:
  • The authorization amount must be greater than zero.
  • The authorization must be submitted for capture within 30 calendar days of its request.
  • After 30 days, the issuer will release the hold on the authorized amount.
  • Send a new authorization request to claim the amount.
For
China UnionPay
, use these services to manage pre-authorizations:
  • Capture service to process a pre-authorization completion. See Captures.
  • Authorization reversal service to reverse a pre-authorization. See Authorization Reversal.
  • Follow-on credit
     service to reverse a pre-authorization completion or sale. See Follow-On Credits.

Endpoint

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

Use these required fields for processing a pre-authorization.
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_cavv
Required for 3-D Secure transactions.
ccAuthService_commerceIndicator
ccAuthService_run
Set the value to
true
.
merchantID
merchantReferenceCode
purchaseTotals_currency
purchaseTotals_grandTotalAmount

Simple Order Example for
China UnionPay
: Processing a Pre-Authorization

Light Dark
Request
1234567891011121314151617
billTo=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=62509470XXXXXXXX
card_expirationMonth=12
card_expirationYear=2025
card_cardType=062
ccAuthService_run=true
ccAuthService_commerceIndicator=internet
merchant_id=npr_paymentech
merchant_referenceCode=TC42703-1
purchaseTotals_currency==100
Response to a Successful Request
12345678910
requestID=6629977932421985593067=ACCEPT
reasonCode=100
merchantReferenceCode=TC42703-1
purchaseTotals_currency=CNY
ccAuthService_reconciliationID=57953165A7YFPS77
ccAuthReply_amount=100.00
ccAuthReply_avsCode=5
ccAuthReply_authorizationCode=570110
ccAuthReply_processorResponse=1
ccAuthReply_authorizedDateTime=2022-09-12T154953Z=123456789619999
Response to a Declined Request
12345678910
requestID=6629977932421985593067=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=233