Merchant-Initiated Incremental Transaction with PAN

An incremental authorization is used to increase the total amount authorized for a payment if the initial authorization does not cover the total cost of goods and services. An incremental transaction is an additional amount to the original authorization. The final authorized total includes amounts for both the initial and the incremental authorizations. Incremental transactions are limited to certain merchant categories, such as rental, lodging, transit, amusement parks, restaurants, and bars.
To create an incremental transaction using the
Business Center
, choose one of these options:
  • Account Top Up
  • No Show

Supported Card Types

These are the supported card types for processing credentialed transactions:
  • American Express
  • Mastercard
  • Visa

Endpoint

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

Required Fields for Processing Merchant-Initiated Incremental Transactions

Use these required fields to process merchant-initiated incremental transactions.
Required only for token transactions with Discover or Diners Club. Set this field to the
ccAuthReply_cardReferenceData
field that was in the response message when you obtained the customer's credentials.
Set the value to
true
.
merchantId
Required only for token transactions with Discover or Diners Club. Set this field to the
ccAuthReply_paymentNetworkTransactionID
field that was in the response message when you obtained the customer's credentials.
Set the value to
5
.
Required only for Discover and Visa.
Set the value to
true
.

Simple Order Example: Processing Merchant-Initiated Incremental Transactions

Request
billTo_street1=201 S. Division St. billTo_city=Foster City billTo_country=US billTo_state=CA billTo_postalCode=94404 purchaseTotals_currency=USD card_expirationMonth=12 card_expirationYear=2031 card_accountNumber=4111111111111111
billTo_email=null@cybersource.com
billTo_firstName=John billTo_lastName=Smith purchaseTotals_grandTotalAmount=100.00 ccIncrementalAuthService_run=true merchantID=pa_ctv_sg101 merchantReferenceCode=33557799 subsequentAuth=Y subsequentAuthTransactionID=016153570198200 ccIncrementalAuthService_authRequestID=6541079409780593413176
Response to a Successful Request
additional_processor_response=e1cdcafc-cdbb-4ef7-8788-a1234e844805 request_id=6461515866500167772420 decision=ACCEPT reasonCode=100 merchantReferenceCode=Merchant_REF purchaseTotals_currency=mxn cardCategory=FccAuthService_reconciliationID=ZUDCXJO8KZRFXQJJ ccAuthReply_amount=100.00 ccAuthReply_avsCode=5 ccAuthReply_authorizationCode=570110 ccAuthReply_processorResponse=1 ccAuthReply_authorizedDateTime=2022-03-01T161947Z ccAuthReply_paymentNetworkTransactionID=111222