Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Release/Capture API

This API is under development. Details will be added once the APIs are signed off in staging/QA.

post/v3/payments/transaction/action

Headers

client_idstring required
client_secretstring required
x_on_behalf_ofstring

This allows parent merchant to consume the API on behalf of sub-merchant.

authorizationstring

Customers can generate JWT using our Auth API with various grant types in the request body. JWT is valid for 15minutes.

Request body

reference_idstring required

A unique ID assigned by the user for this transaction.

original_transaction_idstring

The Decentro Transaction ID received in the initiate collect request/ generate payment link/ generate QR API response.

original_attempt_transaction_idstring

The Attempt Decentro Transaction ID received in the Transaction Status Callback or GTS Advance response.

actionstring

Pass the value as ‘CAPTURE’ if you want us to settle the transaction amount or as 'RELEASE' if you want us to refund the transaction amount.

original_reference_idstring

The Reference ID passed by you in the initiate collect request/ generate payment link/ generate QR API request.

Response

200

OR
OR
OR

Example response

{
  "decentro_txn_id": "410FD1DF02144161BCCAD67CA2F6A59A",
  "api_status": "SUCCESS",
  "message": "Transaction captured successfully",
  "data": {
    "decentro_txn_id": "C1F276C7582E4CE9B46A52067994C2EC",
    "transaction_status": "SUCCESS",
    "attempt_decentro_txn_id": "A41AD4C0DD2D46C1B3F07FE63EDCC448",
    "action_status": "SUCCESS",
    "attempt_status": "SUCCESS",
    "action_status_description": "Transaction captured successfully",
    "original_bank_reference_number": "F411BFB828674950B681FB8AF2C161EC_89"
  },
  "response_key": "success_transaction_capture_success"
}