Transaction

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


Use this API to authenticate with the BOS system and obtain the authorization bearer token. All other API calls must have this token as Authorization header in the format 'Bearer' (without quotes) for them to get processed. The generated token is valid for 600 seconds.

Click to view the steps to generate a public key and the signature.

Body Parameters
{
"mobile":98XXXXXX76,     
"referenceid":1XXXXXXX1,     
"pipe":"bank1|bank2|bank3",     
"pincode":110027,     
"address":"New Delhi",     
"dob":"DD-MM-YYYY",     
"gst_state":"07",     
"bene_id":1XXX2,     
"txntype":"IMPS|NEFT",     
"amount":1XX0 
}
                        
Responses

200

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

401

Response

401

RESPONSE BODY

Object

responsecode integer

status boolean

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/transact' \
--header 'Content-Type: application/json' \
--data  '{
  "mobile": 9800000076,
  "referenceid": 1XXXXXXX1,
  "pipe": "bank1|bank2|bank3",
  "pincode": 110027,
  "address": "New Delhi",
  "dob": "01-01-2000",
  "gst_state": "07",
  "bene_id": 1XXX2,
  "txntype": "IMPS|NEFT",
  "amount": 1XX0
}'
                                
import requests
import json

url = 'https://api.bos.center/api/BOS/transact'
payload = json.dumps({
  "mobile": 9800000076,
  "referenceid": 1XXXXXXX1,
  "pipe": "bank1|bank2|bank3",
  "pincode": 110027,
  "address": "New Delhi",
  "dob": "01-01-2000",
  "gst_state": "07",
  "bene_id": 1XXX2,
  "txntype": "IMPS|NEFT",
  "amount": 1XX0
}) 

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/transact',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
    "mobile": 9800000076,
    "referenceid": 1XXXXXXX1,
    "pipe": "bank1|bank2|bank3",
    "pincode": 110027,
    "address": "New Delhi",
    "dob": "01-01-2000",
    "gst_state": "07",
    "bene_id": 1XXX2,
    "txntype": "IMPS|NEFT",
    "amount": 1XX0
  }) 
}; 
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/transact')
var content = new StringContent(
  "{
    "mobile": 9800000076,
    "referenceid": 1XXXXXXX1,
    "pipe": "bank1|bank2|bank3",
    "pincode": 110027,
    "address": "New Delhi",
    "dob": "01-01-2000",
    "gst_state": "07",
    "bene_id": 1XXX2,
    "txntype": "IMPS|NEFT",
    "amount": 1XX0
  }",
  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/transact',
  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": 9800000076,
    "referenceid": 1XXXXXXX1,
    "pipe": "bank1|bank2|bank3",
    "pincode": 110027,
    "address": "New Delhi",
    "dob": "01-01-2000",
    "gst_state": "07",
    "bene_id": 1XXX2,
    "txntype": "IMPS|NEFT",
    "amount": 1XX0
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;
                                

RESPONSE

200

401

-Result

Example

 
{
  "status": true,
  "response_code": 1,
  "ackno": "XXXX",
  "utr": "XXXXXXXXXXX",
  "txn_status": 1,
  "benename": "BENE NAME",
  "remarks": "Transaction Successful - BENE NAME",
  "message": "Transaction Successful.",
  "customercharge": "40.00",
  "gst": "6.10",
  "tds": "1.57",
  "netcommission": "29.83",
  "remitter": "9515979805",
  "account_number": "48580100004968",
  "Bos_share": "2.5",
  "txn_amount": "4000",
  "balance": 2135786.5
}
                                
 
{
  "status": false,
  "response_code": 25,
  "message": "Authentication failed."
}