Transaction Status Callback v2

This callback is triggered by Decentro to a custom end-point of the platform for each incoming and outgoing transaction initiated through Decentro, once it reaches its terminal status.

🙌

Important Note

Please use only Staging Credentials on each API Reference page to test the APIs directly from our Documentation.

API Endpoints

EnvironmentEndpoint
Staging / Sandboxhttps://your.custom.endpoint.com
Productionhttps://your.custom.endpoint.com

Salient points:

  • Maximum 3 attempts to post the callback, post which the explicit Get status call has to be made for obtaining the transaction status.
  • It is mandatory to adhere to the response structure as specified in the examples.
  • It is recommended that you whitelist Decentro's originating IP.
  • It is recommended that you share your auth of preference with us, which will then be propagated as part of the callback request.
  • Callbacks will be triggered only in case of terminal statuses (failure or success) and not while the transaction is pending.
  • BeneficiaryName and bankReferenceNumber will be present only when Decentro's banking partners respond accordingly.
Body Params
int32
required
Defaults to 1

A numerical value that indicates the attempt no. of the callback

string
required

Timestamp of the CALLBACK. Not the transaction itself.

string
required
Defaults to D43F5G6H47UJ5G4F3R

A URN created for the transaction status callback

string
required
Defaults to D43F5G6H47UJ5G4F3R

The callback URN of the 1st attempt will be present here.

string
required
Defaults to success

The status of the transaction will be present here. "success" and "failure"

string
required
Defaults to 1eeedb6d-b5ca-48ee-ac93-fbe9c11bc55e

The URN created by the platform in the Initiate Payout API

string
required
Defaults to DECXXXXXXXXXXXXXXXXXXXXXXXXXXX

The URN provided by Decentro for the transaction

string
required
Defaults to test txn

The purpose message will be present here

string
required
Defaults to IMPS

IMPS, UPI, NEFT and RTGS will be present here

string
required
Defaults to 227715217094

The bank reference number will be present here. (Note: If the transaction fails without a bank reference number, then this parameter will not be present)

string
required
Defaults to someone

The beneficiary name will be present here

int32
required
Defaults to 100

The transaction amount will be present here

string
required
Defaults to fundTransfer successfully processed

The provider message of the transaction will be present here.

Responses

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