AOP Services

Register Beneficiary

Post https://api.aopay.co.in/api/AOP/DMTV1/RegisterBeneficiary

Beneficiary needs to be registered in the system through remitter's mobile no.

Body Parameters

{
  "MobileNumber": "99XXXXXX88",
  "BeneName": "Rohit",
  "BankID": "207",
  "AccountNumber": "36XXXXXX9",
  "IfscCode": "CBINXXXXX18",
  "DOB": "20/08/2000", 
  "Address": "Delhi",
  "Pincode": "110045",
  "RegistrationID": "AOP-554"
}

Request Parameter

Name	Type	Description
MobileNumber	String	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
MobileNumber	String	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.
AccountNumber	String	The account number of the beneficiary.
IfscCode	String	IFSC code of the branch — used for bank identification in India.
DOB	String	Date of Birth of the user (DD/MM/YYYY).
Address	String	This is a Beneficiary’s address.
Pincode	String	This is a Postal PIN code for the address.
RegistrationID	String	Unique registration identifier, often tied to the user.

Responses

200

Response

200

RESPONSE BODY

object

status boolean

response_code integer

message string

data object

fname string

lname string

mobile string

status string

bank3_limit integer

bank3_status string

bank2_limit integer

bank1_limit integer

202

Response

200

RESPONSE BODY

object

status boolean

response_code integer

stateresp string

message string

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/DMTV1/RegisterBeneficiary' \
--header 'Content-Type: application/json' \
--data  '{
  "MobileNumber": "99XXXXXX88",
  "BeneName": "Rohit",
  "BankID": "207",
  "AccountNumber": "36XXXXXX9",
  "IfscCode": "CBINXXXXX18",
  "DOB": "20/08/2000",
  "Address": "Delhi",
  "Pincode": "110045", 
  "RegistrationID": "AOP-554"
}'

import requests
import json

url = 'https://api.aopay.co.in/api/AOP/DMTV1/RegisterBeneficiary'
payload = json.dumps({
  "MobileNumber": "99XXXXXX88",
  "BeneName": "Rohit",
  "BankID": "207",
  "AccountNumber": "36XXXXXX9",
  "IfscCode": "CBINXXXXX18",
  "DOB": "20/08/2000",
  "Address": "Delhi",
  "Pincode": "110045", 
  "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/DMTV1/RegisterBeneficiary',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
      "MobileNumber": "99XXXXXX88",
      "BeneName": "Rohit",
      "BankID": "207",
      "AccountNumber": "36XXXXXX9",
      "IfscCode": "CBINXXXXX18",
      "DOB": "20/08/2000",
      "Address": "Delhi",
      "Pincode": "110045", 
      "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/DMTV1/RegisterBeneficiary')
var content = new StringContent(
  "{
      "MobileNumber": "99XXXXXX88",
      "BeneName": "Rohit",
      "BankID": "207",
      "AccountNumber": "36XXXXXX9",
      "IfscCode": "CBINXXXXX18",
      "DOB": "20/08/2000",
      "Address": "Delhi",
      "Pincode": "110045", 
      "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/DMTV1/RegisterBeneficiary',
  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 =>  '{
      "MobileNumber": "99XXXXXX88",
      "BeneName": "Rohit",
      "BankID": "207",
      "AccountNumber": "36XXXXXX9",
      "IfscCode": "CBINXXXXX18",
      "DOB": "20/08/2000",
      "Address": "Delhi",
      "Pincode": "110045", 
      "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,
  "message": "Receiver account already exist.",
  "data": {
    "bene_id": "60600077",
    "bankid": "207",
    "bankname": "Rohit",
    "name": "Rohit",
    "accno": "3635009319",
    "ifsc": "CBIN0283318",
    "verified": "0",
    "banktype":"NEFT",
    "status":"1",
    "bank3":null
    },
  "Status":"True",
  "Value":"Receiver account already exist."
}

{
  "status": false,
  "response_code": 0,
  "stateresp": "b3c1e519-cf15-4145-8c26-c3d03e9d2f00",
  "message": "Remitter not registered OTP sent for new registration."
}

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