On This Page
Incremental Authorization
Incremental authorizations are merchant-initiated transactions with no cardholder present at the time of the transaction. They allow you to add additional products and services to an
to append an original pre-authorization to add products and services.
The incremental authorization has these limitations:
- Original transaction must be a pre-authorization.
- Must be in the same currency as the original pre-authorization.
- Maximum of 100 incremental authorizations per transaction, in addition to the initial authorization.
- Interchange optimization is not supported.
- Split shipments are not supported.
These are the supported card types for incremental authorizations:
- American Express
- Discover
- 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 an Incremental Authorization
- ccAuthService_run
- Set the value totrue.
- 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
Country-Specific Required Field for an Incremental Authorization
Use this country-specific required field for 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
Optional Field for Processing an Incremental Authorization
You can use this optional field to
include your transaction ID for an incremental authorization.
- merchantTransactionIdentifier
Related Information
Simple Order Example: 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