On This Page

Incremental Authorization

This section shows you how to process an incremental authorization.

Incremental authorizations allow merchants to add additional products and services to an existing authorization. This section will show you how to append an original authorization to include additional transactions.

The supported card types for incremental authorizations are Mastercard and Visa.

The incremental authorization service has these limitations:

Maximum of 100 incremental authorizations per transaction, in addition to the initial authorization.

Interchange optimization is not supported.

Split shipments are not supported.

Supported Card Types

These card types support incremental authorizations:

Mastercard

Visa

Endpoint

Set the

ccIncrementalAuthService_run

field to

true

Send the request to

https://ics2ws.ic3.com/commerce/1.x/transactionProcessor

Required Fields for Processing an Incremental Authorization

ccAuthService_run: Set the value to
true
.
ccIncrementalAuthService_authRequestID: Set this field to the request ID that was included in the original authorization response message.
merchantID
merchantReferenceCode
purchaseTotals_currency
purchaseTotals_grandTotalAmount
subsequentAuthReason

Related Information

API field reference guide for the Simple Order API

Country-Specific Required Fields for Processing an Incremental Authorization

Use these country-specific required fields to process an incremental authorization.

Argentina

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

Related Information

API field reference guide for the Simple Order API

Optional Field for Processing an Incremental Authorization

You can use this optional field to include your transaction ID when processing an incremental authorization.

merchantTransactionIdentifier

Related Information

API field reference guide for the Simple Order API

Simple Order Example: Processing an Incremental Authorization

Request

ccIncrementalAuthService_run=true
merchantID=pa_ctv_sg101
merchantReferenceCode=33557799
purchaseTotals_currency=USD
purchaseTotals_grandTotalAmount=101.00

Response to a Successful Request

additionalData=ABC
purchaseTotals_currency=USD
purchaseTotals_grandTotalAmount=901.00
ccIncrementalAuthReply_amount=101.00
ccIncrementalAuthReply_authorizationCode=831000
ccIncrementalAuthReply_paymentNetworkTransactionID=016153570198200 
ccIncrementalAuthReply_processorResponse=00
ccIncrementalAuthReply_authorizedDateTime=2022-03-21T174116Z
ccIncrementalAuthReply_reconciliationID=6474558510303169979915
merchantReferenceCode=33557799
receiptNumber=816709
requestID=6478844759930310739813