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:

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.

ccIncrementalAuthService_authRequestID
ccIncrementalAuthService_run: Set the value to
true
.
merchantId
merchantReferenceCode
purchaseTotals_currency
purchaseTotals_grandTotalAmount
subsequentAuthReason: Set the value to
5
.; Required only for Discover and Visa.
subsequentAuth: Set the value to
true
.
subsequentAuthTransactionID

Simple Order Example: Processing Merchant-Initiated Incremental Transactions

Request

123456789101112131415161718
billTo=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=6541079409780593413176

Response to a Successful Request

123456789101112
additional=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=111222