On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/payments/developer/moneris/so/payments/payments-processing-basic-intro/payments-processing-capture-multi-intro.md)  
Filter  
FILTER BY TAG

Multiple Partial Capture {#payments-processing-capture-multi-intro}
===================================================================

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 `Moneris` to have your account enabled for this feature.

Limitations
-----------

Multiple partial captures are supported only with Mastercard and Visa.  
The amount of a follow-on credit cannot exceed the total amount of all partial captures.

Endpoint {#payments-processing-capture-multi-intro_d8e88}
---------------------------------------------------------

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 {#payments-processing-capture-multi-reqfields}
=======================================================================================================

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.
:
When the sequence number is the same as the total count, the capture is the final capture and no additional captures are allowed for the authorization. When the request does not include the sequence number and total count, the capture is the final capture and no additional captures are allowed for the authorization.

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.
:
When the sequence number is the same as the total count, the capture is the final capture and no additional captures are allowed for the authorization. When the request does not include the sequence number and total count, the capture is the final capture and no additional captures are allowed for the authorization.

merchantID
:

merchantReferenceCode
:
Set the value to `merchantReferenceCode` value used in corresponding authorization request.

purchaseTotals_currency
:

purchaseTotals_grandTotalAmount
:
{#payments-processing-capture-multi-reqfields_dl_yjr_glf_tgc}

Related Information {#payments-processing-capture-multi-reqfields_section_sjf_tbv_sxb}
--------------------------------------------------------------------------------------

* [API field reference guide for the Simple Order API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md "")
  {#payments-processing-capture-multi-reqfields_ul_x5z_1bv_sxb}

Simple Order Example: Processing Multiple Partial Captures {#payments-processing-multi-capture-ex-so}
=====================================================================================================

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>
```

RELATED TO THIS PAGE