Payout Links

This collection of APIs enables you to send a unique link to any customer/agent/vendor who is waiting to receive a payout from your business. Using this link, the respective person can input their bank account details or directly the UPI ID to receive the money into the linked bank account.

As soon as they submit the details and proceed, the money gets instantly transferred via IMPS/UPI to the bank account or UPI ID.

Generate Payout Link

Generate a payout link from a virtual account to any UPI ID/ bank account.

📘

Currently available only for 'Yes Bank' as a provider bank

curl --location --request POST 'https://in.staging.decentro.tech/v2/payments/payout/link' \
--header 'client_id: <YOUR_CLIENT_ID>' \
--header 'client_secret: <YOUR_CLIENT_SECRET>' \
--header 'module_secret: <YOUR_PAYMENTS_MODULE_SECRET>' \
--header 'provider_secret: <YOUR_PROVIDER_SECRET>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_id": "0000-0000-0000-0001",
    "payer_account": "462515XXXXXXXXXXXX",
    "amount": 243,
    "purpose_message": "Creating payout link for bill payment"
}'
{
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "status": "SUCCESS",
  "responseCode": "S00000",
  "message": "Payout Link created Successfully",
  "data": {
    "shortenLink": "<payout_url>",
    "transactionId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "transactionStatus": "NOT_INITIATED"
  }
}

Check Payout Status

Check the real-time status of the payout link created by you.

curl --location --request GET 'https://in.staging.decentro.tech/core_banking/money_transfer/get_status?decentro_txn_id=DECXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
--header 'client_id: <YOUR_CLIENT_ID>' \
--header 'client_secret: <YOUR_CLIENT_SECRET>' \
--header 'module_secret: <YOUR_BANKING_MODULE_SECRET>' \
--header 'provider_secret: <YOUR_PROVIDER_SECRET>' \
--header 'Content-Type: application/json'
{
  "status": "success",
  "originalTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "originalDecentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "originalTransactionResponse": {
    "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "status": "SUCCESS",
    "responseCode": "S00000",
    "message": "Payout Link created Successfully",
    "data": {
      "shortenLink": "<payout_url>",
      "transactionId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "transactionStatus": "NOT_INITIATED"
    }
  },
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "bankReferenceNumber": "XXXXXXXXXXXX",
  "transferType": "UPI"
}