VyomPay
  1. Payout APIs
VyomPay
  • Introduction
  • Process Flow
  • Error Codes
  • Common APIs
    • Wallet Balance Check
      POST
  • Payout APIs
    • Add NEFT/IMPS Beneficiary
      POST
    • Add UPI Beneficiary
      POST
    • Delete Beneficiary
      POST
    • Get Beneficiary List
      POST
    • NEFT/IMPS Validate Beneficiary
      POST
    • Validate UPI Beneficiary
      POST
    • Payout Transaction Request
      POST
    • Direct Payout Transaction Request
      POST
    • Transaction Status
      POST
    • Transaction Status By Request ID
      POST
    • Payout Transaction Complain
      POST
    • Payout Callback
      POST
    • Virtual Account Wallet Credit Callback
      POST
    • Service Bank List
      POST
    • Service List
      POST
  • Payin APIs
    • Generate Merchant Payment Link
      POST
    • Generate Merchant PG Order
      POST
    • Generate Merchant UPI PG QR
      POST
    • Merchant UTR Process
      POST
    • Check Order Status
      POST
    • Payin Callback
      POST
  1. Payout APIs

Add NEFT/IMPS Beneficiary

Testing
POST
/Payout/Action/addBeneficiary

Request

Header Params
Content-Type
string 
required
Example:
application/json
Body Params application/json
username
string 
required
api_key
password
string 
required
api_secret
requestid
string 
required
A unique id referencing the current request
beneficiary_name
string 
required
Name of the Beneficiary
beneficiary_type
string 
required
IMPS/NEFT
beneficiary_account_number
string 
required
Account number of the Beneficiary
beneficiary_bank_ifsc
string 
required
IFSC code of the Beneficiary
service_bank_id
string 
optional
beneficiary_account_type
string 
required
Account Type of the Beneficiary, e.g. "SB", "CA", "OD"
SB - Saving Bank
CA - Current Account
OD - Over Draft
Example
{
  "username": "********",
  "password": "********",
  "requestid": "9iL7CMTUau8n8HvJmDkQOJ",
  "beneficiary_name": "Test API Bene 2",
  "beneficiary_type": "NEFT/IMPS",
  "beneficiary_account_number": "48941638949618614864",
  "beneficiary_bank_ifsc": "IOBA0002136",
  "service_bank_id": "144366",
  "beneficiary_account_type": "CA"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://uat.nandishatech.com/WS/v1/Payout/Action/addBeneficiary' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "********",
    "password": "********",
    "requestid": "9iL7CMTUau8n8HvJmDkQOJ",
    "beneficiary_name": "Test API Bene 2",
    "beneficiary_type": "NEFT/IMPS",
    "beneficiary_account_number": "48941638949618614864",
    "beneficiary_bank_ifsc": "IOBA0002136",
    "service_bank_id": "144366",
    "beneficiary_account_type": "CA"
}'

Responses

🟢200Add NEFT/IMPS Beneficiary
application/json
Body
Resp_code
string 
required
Resp_desc
string 
required
requestid
string 
required
data
object 
required
agent_id
string 
required
beneficiary_id
integer 
required
beneficiary_name
string 
required
beneficiary_account_number
string 
required
beneficiary_bank_name
string 
required
beneficiary_bank_ifsc
string 
required
beneficiary_account_type
string 
required
status
string 
required
added_on
string 
required
Example
{
  "Resp_code": "RCS",
  "Resp_desc": "Beneficiary Added Successfully",
  "requestid": "rGZOlz2GW2zn131oJOmQ",
  "data": {
    "agent_id": "US000001",
    "beneficiary_id": 16,
    "beneficiary_name": "Test API Bene 2",
    "beneficiary_account_number": "48941638949618614864",
    "beneficiary_bank_name": "Indian Overseas Test",
    "beneficiary_bank_ifsc": "IOBA0002136",
    "beneficiary_account_type": "CA",
    "status": "ACTIVE",
    "added_on": "2023-10-05 13:42:18"
  }
}
Modified at 2025-04-10 11:13:29
Previous
Wallet Balance Check
Next
Add UPI Beneficiary
Built with