AOP Services

Beneficiary Name Verify

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

This API is used to verify the name of a beneficiary by cross-referencing the provided account details with the registered information. It is typically used before initiating a fund transfer to ensure that the account holder's name matches the intended beneficiary, helping to prevent errors and fraud.

Body Parameters

{
    "mobile":"98XXXXXX76",
    "bene_id":"9XXXXX4",
    "accno":"5XXXXXXXXXXX2",
    "bankid":"309",
    "benename":"XYZ ABCD",
    "referenceid":"1234435687678",
    "pincode":"2XXXX6",
    "address":"New delhi",
    "dob":"20/02/2015",
    "gst_state":"07",
    "RegistrationID":"AOP-554"
}

Request Parameters

Name	Type	Description
mobile	String	The Mobile number of the user, often used for verification or notifications.
bene_id	String	The unique ID of the beneficiary registered under that sender. This ID is used for money transfers, deletion, or fetching beneficiary details.
accno	String	The account number of the beneficiary.

Table

Name	Type	Description
mobile	String	The Mobile number of the user, often used for verification or notifications.
bene_id	String	The unique ID of the beneficiary registered under that sender. This ID is used for money transfers, deletion, or fetching beneficiary details.
accno	String	The account number of the beneficiary.
bankid	String	This is a bank's unique internal ID, taken from a predefined list of banks.
benename	String	Name of the bank account holder.
referenceid	String	A unique identifier used to track or reference a specific transaction, request, or process. In this case, "1234435687678" could be an order ID, payment ID, or service request ID.
pincode	String	This is the Postal PIN code for the address.
address	String	This is the Beneficiary’s address.
dob	String	Date of Birth of the beneficiary(DD/MM/YYYY).
gst_state	String	This is the State code as per GST.
RegistrationID	String	Unique registration identifier, often tied to the user.

Responses

200

Response

200

RESPONSE BODY

object

status boolean

response_code integer

data array of objects

object

bene_id string

bankid string

bankname string

name string

accno string

ifsc string

verified string

banktype string

paytm boolean

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/Benenameverify' \
--header 'Content-Type: application/json' \
--data  '{
  "mobile": "98XXXXXX76",
  "bene_id": "9XXXXX4",
  "accno": "5XXXXXXXXXXX2",
  "bankid": "309",
  "benename": "XYZ ABCD",
  "referenceid": "1234435687678",
  "pincode": "2XXXX6",
  "address": "New delhi",
  "dob": "20/02/2015",
  "gst_state": "07",
  "RegistrationID": "AOP-554"
}'

import requests
import json

url = 'https://api.aopay.co.in/api/AOP/Benenameverify'
payload = json.dumps({
  "mobile": "98XXXXXX76",
  "bene_id": "9XXXXX4",
  "accno": "5XXXXXXXXXXX2",
  "bankid": "309",
  "benename": "XYZ ABCD",
  "referenceid": "1234435687678",
  "pincode": "2XXXX6",
  "address": "New delhi",
  "dob": "20/02/2015",
  "gst_state": "07",
  "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/Benenameverify',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
    "mobile": "98XXXXXX76",
    "bene_id": "9XXXXX4",
    "accno": "5XXXXXXXXXXX2",
    "bankid": "309",
    "benename": "XYZ ABCD",
    "referenceid": "1234435687678",
    "pincode": "2XXXX6",
    "address": "New delhi",
    "dob": "20/02/2015",
    "gst_state": "07",
    "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/Benenameverify')
var content = new StringContent(
  "{
    "mobile": "98XXXXXX76",
    "bene_id": "9XXXXX4",
    "accno": "5XXXXXXXXXXX2",
    "bankid": "309",
    "benename": "XYZ ABCD",
    "referenceid": "1234435687678",
    "pincode": "2XXXX6",
    "address": "New delhi",
    "dob": "20/02/2015",
    "gst_state": "07",
    "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/Benenameverify',
  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",
    "bene_id": "9XXXXX4",
    "accno": "5XXXXXXXXXXX2",
    "bankid": "309",
    "benename": "XYZ ABCD",
    "referenceid": "1234435687678",
    "pincode": "2XXXX6",
    "address": "New delhi",
    "dob": "20/02/2015",
    "gst_state": "07",
    "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": "9XXXXX4",
      "bankid": "309",
      "bankname": "HDFC BANK",
      "name": "XYZ ABCD",
      "accno": "5XXXXXXXXXX2",
      "ifsc": "HDFC000XXXX",
      "verified": "0",
      "banktype": "ALL",
      "paytm": true
    }
  ],
  "message": "Beneficiary fetched successfully."
}

 
{
  "response_code": 11,
  "status": false,
  "message": "Authentication failed"
}