Incremental Authorizations

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

Use these required fields for processing an incremental authorization.
When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see Relaxed Requirements for Address Data and Expiration Date in Payment Transactions.
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
When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see Relaxed Requirements for Address Data and Expiration Date in Payment Transactions.

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.

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