Partial Captures
Requirements
No MultipartCapture request should be sent before receiving the response of a preceding request (i.e. no parallel calls are allowed). The timeout for this are 100 seconds.
The total amount of all executed multipart captures must not exceed the authorized amount of the initial transaction.
A unique
OrderPartId
must be used for each request.
Executing a Multipart Capture
Type: The Type specifies, whether this is one of many subsequent, or the final Capture.
The overall amount you submit is not checked on the test-environment, as it is rejected by the processor/acquirer! So it is indeed possible to capture more, than authorized!
Finalizing a Capture-Chain
Does the merchant intend to capture a final amount, or not?
Once finalized, a transaction cannot be opened again. Make sure, that you really want to finalize the transaction. Other captures won't be possible!
Finalizing, while also capturing a certain amount
Like mentioned previously, make sure to not exceed the initially authorized amount, or the capture will fail!
Finalizing without capturing/ Capturing with amount 0
Finalize may only be executed, if the remaining amount is greater, than 0!
If you use a normal Multipart Capture to capture the whole transaction amount, please make sure, that the last partial capture is marked as "Type": "FINAL"
.
Executing a Multipart Finalize on such a transaction will lead to an error.
Why do you need to finalize a transaction?
There are two reasons, why you, the merchant, should finalize a transaction, once you have finished all your actions:
It is the cleaner process. For you, the merchant, this is the cleaner solution and helps keeping track of every transaction and its status, not just inside your own system, but also inside the Saferpay Backoffice, where still open and closed transactions will be marked as such!
It means less hassle for your customers! Each time you successfully authorize a credit card, the authorized amount gets reserved on the cardholders credit limit. That effectively means, that he/she cannot use this money, as long as you haven't claimed the money, or the reservation voids, after a certain time-frame. A finalization will open up the credit-limit for the cardholder, so he/she may use it again, which is especially important in situations, where the merchant does not want, or can't claim all the money originally authorized!
Handling Refunds
Last updated