AOP Services

Register Beneficiary

Post https://api.aopay.co.in/api/AOP/RegisterBaneficiary

In this API, you will provide essential beneficiary and account details, including contact information, banking credentials, verification status, location identifiers, and date of birth, along with the user's registration reference. These values are required to securely register or update beneficiary information for financial transactions or compliance purposes.

Body Parameters

{
"mobile": "98XXXXXX76",      
"benename": "Rohit",      
"bankid": "309",      
"accno": "5XXXXXXXXXXX2",      
"ifsccode": "HDFC000XXX5",      
"verified": "0",      
"gst_state": "07",      
"dob": "20-05-2020",      
"address": "New delhi",      
"pincode": "560001",
"RegistrationID": "AOP-554"
}

Request Parameters

Name	Type	Description
mobile	String	The Mobile number of the user, often used for verification or notifications.
benename	String	Name of the bank account holder.
bankid	String	This is a bank's unique internal ID, taken from a predefined list of banks.

Table

Name	Type	Description
mobile	String	The Mobile number of the user, often used for verification or notifications.
benename	String	Name of the bank account holder.
bankid	String	This is a bank's unique internal ID, taken from a predefined list of banks.
accno	String	The account number of the beneficiary.
ifsccode	String	IFSC code of the branch — used for bank identification in India.
verified	String	This is the Status of bank account verification."0" means not verified, "1" would mean verified.
gst_state	String	This is the State code as per GST.
dob	String	Date of Birth of the beneficiary(DD/MM/YYYY).
address	String	This is the Beneficiary’s address.
pincode	String	This is the Postal PIN code for the address.
RegistrationID	String	Unique registration identifier, often tied to the user.

Responses

200

Response

200

RESPONSE BODY

Json

401

Response

401

RESPONSE BODY

Object

responsecode integer

status boolean

message string

Did this page help you? Yes No

Language

Shell

Python

Node

PHP

cURL

curl --location 'https://api.aopay.co.in/api/AOP/RegisterBaneficiary' \
--header 'Content-Type: application/json' \
--data  '{
  "mobile": "98XXXXXX76",
  "benename": "Rohit",
  "bankid": "309",
  "accno": "5XXXXXXXXXXX2",
  "ifsccode": "HDFC000XXX5",
  "verified": "0",
  "gst_state": "07",
  "dob": "20-05-2020",
  "address": "New delhi",
  "pincode": "560001",
  "RegistrationID": "AOP-554"
}'

import requests
import json

url = 'https://api.aopay.co.in/api/AOP/RegisterBaneficiary'
payload = json.dumps({
  "mobile": "98XXXXXX76",
  "benename": "Rohit",
  "bankid": "309",
  "accno": "5XXXXXXXXXXX2",
  "ifsccode": "HDFC000XXX5",
  "verified": "0",
  "gst_state": "07",
  "dob": "20-05-2020",
  "address": "New delhi",
  "pincode": "560001",
  "RegistrationID": "AOP-554"
}) 

headers = {
  "Content-type" : "application/json"
}

response = requests.request("POST", url, headers=headers, data=payload)

print (response.text)

var requests = require("request");
var options = { 
  "method" : "POST",
  "url" : 'https://api.aopay.co.in/api/AOP/RegisterBaneficiary',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
    "mobile": "98XXXXXX76",
    "benename": "Rohit",
    "bankid": "309",
    "accno": "5XXXXXXXXXXX2",
    "ifsccode": "HDFC000XXX5",
    "verified": "0",
    "gst_state": "07",
    "dob": "20-05-2020",
    "address": "New delhi",
    "pincode": "560001",
    "RegistrationID": "AOP-554"
  }) 
}; 
request(options, function(error, response){
   if(error) throw new Error(error);
   console.log(response.body); 
});

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post,'https://api.aopay.co.in/api/AOP/RegisterBaneficiary')
var content = new StringContent(
  "{
    "mobile": "98XXXXXX76",
    "benename": "Rohit",
    "bankid": "309",
    "accno": "5XXXXXXXXXXX2",
    "ifsccode": "HDFC000XXX5",
    "verified": "0",
    "gst_state": "07",
    "dob": "20-05-2020",
    "address": "New delhi",
    "pincode": "560001",
    "RegistrationID": "AOP-554"
  }",
  null,"application/json"
); 

request.Content = content;
var response =  await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

<?php
$curl =  curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL =>  'https://api.aopay.co.in/api/AOP/RegisterBaneficiary',
  CURLOPT_RETURNTRANSFER =>  true,
  CURLOPT_ENCODING =>  '',
  CURLOPT_MAXREDIRS =>  10,
  CURLOPT_TIMEOUT =>  0,
  CURLOPT_FOLLOWLOCATION =>  true,
  CURLOPT_HTTP_VERSION =>  CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =>  'POST',
  CURLOPT_POSTFIELDS =>  '{
    "mobile": "98XXXXXX76",
    "benename": "Rohit",
    "bankid": "309",
    "accno": "5XXXXXXXXXXX2",
    "ifsccode": "HDFC000XXX5",
    "verified": "0",
    "gst_state": "07",
    "dob": "20-05-2020",
    "address": "New delhi",
    "pincode": "560001",
    "RegistrationID": "AOP-554"
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;

RESPONSE

 
{
    "status": true,
    "response_code": 1,
    "data": {
        "bene_id": 900XXXX,
        "bankid": "309",
        "bankname": "HDFC BANK",
        "name": "Rohit",
        "accno": "5XXXXXXXXXXX2",
        "ifsc": "HDFC000XXX5",
        "verified": "0",
        "banktype": "ALL",
        "status": 1,
        "bank3": true
    },
    "message": "Receiver account successfully added."
}

 
{
  "responsecode": 12,
  "status": false,
  "message": "Authentication failed"
}