Capture / Cancel Authorization
Applicable Market: ZA South Africa
Request path
Perform a capture (charge) or cancel (release without charge) on an authorized order. The same endpoint is used; the operation is distinguished by the action parameter.
Prerequisite: The order must have
orderStatus = 5 (required_capture)before this endpoint can be called.
Request Parameters
Yes = Required · No = Optional
action Enum
Response
Examples
capture (Charge)
cancel (Release)
Response
Order Status Flow
Important Notes
- Asynchronous Processing: A synchronous response with
orderStatus=1only indicates that the request has been accepted. The final outcome must be confirmed via order query or asynchronous notification. - Idempotency: The
idempotencyIdensures that duplicate calls do not result in duplicate charges. - Cancel is Irreversible: Once cancelled, the authorized amount is released back to the cardholder and cannot be recovered. A new order must be created if a charge is subsequently needed.
- Capture Amount:
amountmust be ≤ the authorized amount.