Add Beneficiary

Post  https://api.bos.center/api/BOS/FPAddBeneficiary


Body Parameters
{
    "account_number": "9XXXXXXX339722",
    "address": "XXXX",
    "allowed_payment_types": [
       1/3  [1 = NEFT, 2 = UPI, 3 = IMPS, 4 = RTGS]
    ],
    "email": "XXXX@gmail.com",
    "ifsc_code": "UTIXXXXX19",
    "mobile_number": "99XXXXX",
    "name": "NXXXX DXXXX",
    "Vpa": "", [Pass As it is in case of allow Payment type NEFT, IMPS]
    "RegistrationID": "BOS-554",
    "BOSflag": "sample string 9"
}
Responses

200

200

Response

200

RESPONSE BODY

object

status    string

subCode    string

message    string

403

403

Response

403

RESPONSE BODY

Object

status string

subCode string

message string


Did this page help you?     Yes    No

Language
shell Shell
python Python
node Node
c# C#
php PHP

cURL

curl --location 'https://api.bos.center/api/BOS/FPAddBeneficiary' \
--header 'Content-Type: application/json' \
--data  '{
  "account_number": "9XXXXXXX339722",
  "address": "XXXX",
  "allowed_payment_types": [
    1/3   [1 = NEFT, 2 = UPI, 3 = IMPS, 4 = RTGS]
  ],
  "email": "XXXX@gmail.com",
  "ifsc_code": "UTIXXXXX19",
  "mobile_number": "99XXXXX",
  "name": "NXXXX DXXXX",
  "Vpa": "", [Pass As it is in case of allow Payment type NEFT, IMPS]
  "RegistrationID": "BOS-554",
  "BOSflag": "sample string 9"
}'
                                
import requests
import json

url = 'https://api.bos.center/api/BOS/FPAddBeneficiary'
payload = json.dumps({
  "account_number": "9XXXXXXX339722",
  "address": "XXXX",
  "allowed_payment_types": [
    1/3   [1 = NEFT, 2 = UPI, 3 = IMPS, 4 = RTGS]
  ],
  "email": "XXXX@gmail.com",
  "ifsc_code": "UTIXXXXX19",
  "mobile_number": "99XXXXX",
  "name": "NXXXX DXXXX",
  "Vpa": "", [Pass As it is in case of allow Payment type NEFT, IMPS]
  "RegistrationID": "BOS-554",
  "BOSflag": "sample string 9"
}) 

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.bos.center/api/BOS/FPAddBeneficiary',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
    "account_number": "9XXXXXXX339722",
    "address": "XXXX",
    "allowed_payment_types": [
      1/3   [1 = NEFT, 2 = UPI, 3 = IMPS, 4 = RTGS]
    ],
    "email": "XXXX@gmail.com",
    "ifsc_code": "UTIXXXXX19",
    "mobile_number": "99XXXXX",
    "name": "NXXXX DXXXX",
    "Vpa": "", [Pass As it is in case of allow Payment type NEFT, IMPS]
    "RegistrationID": "BOS-554",
    "BOSflag": "sample string 9"
  }) 
}; 
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.bos.center/api/BOS/FPAddBeneficiary')
var content = new StringContent(
  "{
    "account_number": "9XXXXXXX339722",
    "address": "XXXX",
    "allowed_payment_types": [
      1/3   [1 = NEFT, 2 = UPI, 3 = IMPS, 4 = RTGS]
    ],
    "email": "XXXX@gmail.com",
    "ifsc_code": "UTIXXXXX19",
    "mobile_number": "99XXXXX",
    "name": "NXXXX DXXXX",
    "Vpa": "", [Pass As it is in case of allow Payment type NEFT, IMPS]
    "RegistrationID": "BOS-554",
    "BOSflag": "sample string 9"
  }",
  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.bos.center/api/BOS/FPAddBeneficiary',
  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 =>  '{
    "account_number": "9XXXXXXX339722",
    "address": "XXXX",
    "allowed_payment_types": [
      1/3   [1 = NEFT, 2 = UPI, 3 = IMPS, 4 = RTGS]
    ],
    "email": "XXXX@gmail.com",
    "ifsc_code": "UTIXXXXX19",
    "mobile_number": "99XXXXX",
    "name": "NXXXX DXXXX",
    "Vpa": "", [Pass As it is in case of allow Payment type NEFT, IMPS]
    "RegistrationID": "BOS-554",
    "BOSflag": "sample string 9"
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;
                                

RESPONSE

200

403

409

412

422

-Result

Example

{
  "id": 4XXXXX91XX5,
  "allowed_payment_types": [1/3], 1 is for NEFT and 3 for IMPS
  "status": "Success",
  "name": "NXXXX DXXXX",
  "bank_name": null,
  "ifsc_code": "UTIXXXXX19",
  "account_number": "9XXXXXXX339722",
  "vpa": null,
  "mobile_number": "99XXXXX",
  "email": "XXXX@gmail.com",
  "address": "XXXX",
  "created_at": "2024-01-16T06:50:47.599951Z",
  "updated_at": "2024-01-16T06:50:47.599968Z",
  "message": "{\"id\":4XXX9XX5,\"business\":226,\"allowed_payment_types\":[3],\"status\":\"Active\",\"name\":\"NXXXX DXXXX\",\"bank_name\":null,\"ifsc_code\":\"UTIBXXXXXX19\",\"account_number\":\"9XXXXXXX339722\",\"vpa\":null,\"mobile_number\":\"99XXXXXX\",\"email\":\"XXXX@gmail.com\",\"address\":\"XXXXXX\",\"created_at\":\"2024-01-16T06:50:47.599951Z\",\"updated_at\":\"2024-01-16T06:50:47.599968Z\"}",
  "subCode": "200"
}
                                
{
  "status": "ERROR",
  "subCode": "403",
  "message": "APIs not enabled. Please reach out to care@bos.com"
}
                                
  
{
  "status": "ERROR",
  "subCode": "409",
  "message": "Beneficiary Id already exists"
}
                                
{
  "status": "ERROR",
  "subCode": "412",
  "message": "Post data is empty or not a valid JSON"
}
                                
{
  "status": "ERROR",
  "subCode": "422",
  "message": "Please provide a valid Bank IFSC code."
}