On This Page

Multiple Partial Captures

This section shows you how to process multiple partial captures for an authorization.

This feature enables you to request multiple partial captures for one authorization. A multiple partial capture allows you to incrementally settle authorizations over time. Ensure that the total amount of all the captures does not exceed the authorized amount.

Fields Specific to This Use Case

These API request fields and values are specific to this use case:

ccCaptureService_sequence
ccCaptureService_totalCount

Prerequisite

Contact customer support to have your account enabled for this feature.

Limitations

Your account can be enabled for multiple partial captures or split shipments; it cannot be enabled for both features.

Endpoint

Set the

ccCaptureService_run

field to

true

Send the request to

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

Required Fields for Processing Multiple Partial Captures

ccCaptureService_authRequestID
ccCaptureService_run: Set the value to
true
.
ccCaptureService_sequence: For the final capture request, set this field and
ccCaptureService_totalCount
to the same value.
ccCaptureService_totalCount: When you do not know the total number of captures that you are going to request, set this field to at least one more than the
ccCaptureService_sequence
field until you reach the final capture. For the final capture request, set this field and
ccCaptureService_sequence
to the same value.
merchantID
merchantReferenceCode: Set the value to
merchantReferenceCode
value used in corresponding authorization request.
purchaseTotals_currency
purchaseTotals_grandTotalAmount

Related Information

API field reference guide for the Simple Order API

Simple Order Example: Processing Multiple Partial Captures

Request

<requestMessage
	xmlns="urn:schemas-cybersource-com:transaction-data-1.225">
	<merchantID>MERCHANT_ID</merchantID>
	<merchantReferenceCode>TC_FE_MD-1</merchantReferenceCode>
	<purchaseTotals>
		<currency>SAR</currency>
		<grandTotalAmount>10</grandTotalAmount>
	</purchaseTotals>
	<ccCaptureService run="true">
		<authRequestID>7429184781587007513700</authRequestID>
		<sequence>1</sequence>
		<totalCount>3</totalCount>
	</ccCaptureService>
</requestMessage>

Response to a Successful Request

<c:replyMessage
	xmlns:c="urn:schemas-cybersource-com:transaction-data-1.217">
	<c:merchantReferenceCode>TC_FE_MD-1</c:merchantReferenceCode>
	<c:requestID>7067731204117000415775</c:requestID>
	<c:decision>ACCEPT</c:decision>
	<c:reasonCode>100</c:reasonCode>
	<c:purchaseTotals>
		<c:currency>SAR</c:currency>
	</c:purchaseTotals>
	<c:ccCaptureReply>
		<c:reasonCode>100</c:reasonCode>
		<c:requestDateTime>2024-02-01T07:38:40Z</c:requestDateTime>
		<c:amount>100.00</c:amount>
		<c:reconciliationID>7067730865997000315775</c:reconciliationID>
		<c:authorizationCode>830SPG</c:authorizationCode>
		<c:processorResponse>00</c:processorResponse>
	</c:ccCaptureReply>
</c:replyMessage>