Skip to main content
POST
/
v1
/
user
/
product
/
payouts
/
pay
Initiate Payout
curl --request POST \
  --url https://api.unpay.in/v1/user/product/payouts/pay \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "debit_account_id": "UNPW4065468842",
  "bene_id": "BENE0407717739",
  "bene_bank_id": 86,
  "amount": 5,
  "payment_mode": "IMPS",
  "narration": "payout",
  "purpose": "test",
  "notes": "test"
}
'
{
  "success": true,
  "transaction_id": "TXN20260413001",
  "status": "PENDING",
  "message": "Payout initiated successfully"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
debit_account_id
string
required

Your UnPay wallet/account ID to debit from.

Example:

"UNPW4065468842"

​
bene_id
string
required

Registered beneficiary ID.

Example:

"BENE0407717739"

​
bene_bank_id
integer
required

Internal bank ID of the beneficiary's bank.

Example:

86

​
amount
number
required

Amount to transfer (in INR).

Example:

5

​
payment_mode
enum<string>
required

Payment mode for the transfer.

Available options:
IMPS,
NEFT,
RTGS
Example:

"IMPS"

​
narration
string
required

Transaction narration or reference note.

Example:

"payout"

​
purpose
string
required

Purpose of the payout.

Example:

"test"

​
notes
string

Additional notes for internal tracking.

Example:

"test"

Response

Payout initiated successfully

​
success
boolean
Example:

true

​
transaction_id
string
Example:

"TXN20260413001"

​
status
string
Example:

"PENDING"

​
message
string
Example:

"Payout initiated successfully"