Capture Transaction

This API is used to capture the authorized transaction at gateway/processor. It supports partial captures for amount less than or equal to actual amount of original AUTH transaction. Capture of the transaction is allowed only when the transaction is authorized at gateway/processor.

HTTP Status and Response Status Matrix

HTTP StatusResponse StatusResponse Message
200CAPTURED / CAPTURE_PENDINGSuccess
400VALIDATION_ERRORWhen validation fails for request body,
field specific validation
errors will be returned.
400REJECTEDTransaction UTR provided is not found
400REJECTEDCapture transaction only allowed if
transaction type is AUTH
400REJECTEDTransaction denied as Capture amount
should not exceed Auth amount
400REJECTEDEither transaction is already captured or not allowed
500ERROR_FROM_PGError in processing gateway response
500INTERNAL_PROCESSING_ERRORWhen there is an error/exception at Checkout
which is not handled gracefully or un-recoverable.
Specific error messages or generic error
message will be returned basis on the scenario.
502,503ERROR_CONNECTING_PGGateway connectivity unavailable
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 45
^txn[_0-9A-Za-z]+$

Unique transaction reference (UTR) number generated by checkout for original transaction.

string
required
length ≤ 20
^[0-9]+$

Amount to be captured. Amount is always considered in the smallest currency sub-unit i.e. to do a transaction of 100 USD, provide 10000 as value. In the case of three decimal currencies, such as KWD, BHD and OMR, pass the value as 100000.

Headers
string
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json