---
title: "Bank Payout"
method: POST
path: "/bank-payout"
---

# Bank Payout

`POST /bank-payout`

API to request payment from bank accounts enabled for this functionality. If Multi-Factor Authentication is enabled in Program configuration then the OTP will be sent out using the method selected.

## Request body

- object
  - `entityId` string, required — Entity ID for your organization
  - `programId` string, required — Program ID related to payout activity
  - `bankCode` string, required — 4-character bank code (see example table below)
  - `customerId` string, required — Customer / Corporate ID issued by the bank for the account to be debited.
  - `custTxnRefNo` string, required — Your unique internal reference number for this payout request.
  - `externalReferenceNumber` string — A unique reference number for this payoutrequest
  - `debitAcctNo` string, required — The account from which the amount should be debited.
  - `callbackUrl` string — The API endpoint where we will submit updates on the payment status for each custTxnRefNo.
  - `payment.txnType` string, required — IMPS/NEFT/RTGS/IFT
  - `payment.amount` number, required — Num The amount to be debited for this payout request. Positive values only will be considered.
  - `payment.valueDate` string, required — The value date to be posted for this transaction in YYYY-MM-DD format. Should be the current date only.
  - `payment.benCode` string — Beneficiary code. Required for Beneficiary Code based payout
  - `payment.benName` string, required — Beneficiary name
  - `payment.benIFSC` string — IFS code for the beneficiary bank account. Required for Beneficiary Account based payout
  - `payment.benAcctNo` string — Beneficiary account number. Required for Beneficiary Account based payout
  - `payment.benEmail` string — Beneficiary email address
  - `payment.benMobile` string — Beneficiary mobile number (without country code)
  - `payment.description` string — description for the transaction
  - `payment.remark1` string — Remark for the transaction
  - `payment.remark2` string — Remark for the transaction
  - `payment.remark3` string — Remark for the transaction

## Response `200`

Successful response

- object
  - `custTxnRefNo` string — Alphanumeric reference received in the request
  - `status` string — success / failure
  - `message` string — success / failure
  - `entityId` string — Entity ID for your organization
  - `utrNo` string — UTR No. for the payout
  - `programId` string — programId

---

[API](https://skmtc.net/jiopay/apis/jiopay-pg.md) · [All operations](https://skmtc.net/jiopay/apis/jiopay-pg/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jiopay/jiopay-pg/revisions/55aa41b8482f/schema)