On This Page
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 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
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.
Related Information
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
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