Link Account

This API is used for Link Account

LinkAccount

POST

Link Account

 

 

Description

 

This API links the account of one entity with the other entity

 

 

Version


V2


Resource URL

https://sandbox.jsbl.com/v2 /linkacc-blb


Header


Name Type Values Description Length

Authorization

String Bearer
Example: Bearer xxxxxxxxxxxxx
Access Token will be generated through OAuth API NA

Content-Type

String Example:
application/json
Only “application/json” Content-Type is supported. NA


 

 

Request Parameters

 

Name Description Parameter Type Sample Value

MerchantType

Merchant Type String 0088

TraceNo

Trace No Only numbers are allowed 451198

CompanyName

Company Name String XXXXX

DateTime

Date Time YYYYMMddHHmmss 20170706121213

TransactionType

Transaction Type String 01

MobileNo

Mobile No String 03422142169

Cnic

Cnic String 3540422876499

Reserved1

Reserved 1 String 02

OtpPin

Otp Pin String

QQYItyE8jkSFF3v7ApxVaOEpmwbp1gMwxo4Y8BOvzk4wx3

EpzVucMfa5Nqwtu3g259ZZXbJ2rIF3lq8m8DjsgPvfizujtE3OE

FfT9H1C5zeYp4w7WDbZxSkcNGGJMdP/tcwiQJqGHDVkos

bOadD3z9rBdX+KeumGN6Rjx3Bpmwh6mHoBxjF+6dc1XO

u3GwtOc4OFDbMvj+YRXLjeyaLSYaVpVZkL+Q/s7U91LQ

AnoYhdxhx8HAx0KpIQkAw9I2eQuK0FGRTsuR773mW1gY

aZoNDAR+Dl+WyLl9F9HHoB81n6NkyJAF5PIzbqtMkBbRp

UU043AezTXrmSV+a/UuhDMw==

 

 

 

Sample  Request

{

"LinkAccountRequest":

{

"MerchantType": "0088",

"TraceNo" : "451198",

"CompanyName" : "XXXXX",

"DateTime" : "20170706121213",

"TransactionType" : "01",

"MobileNo" : "03422142169",

"Cnic" : "3540422876499",

"Reserved1" : "02",

"OtpPin" : "QQYItyE8jkSFF3v7ApxVaOEpmwbp1gMwxo4Y8BOvzk4wx3EpzVucMfa5Nqwtu3g259ZZXbJ2rIF3lq8m8Dj sgPvfizujtE3OEFfT9H1C5zeYp4w7WDbZxSkcNGGJMdP/tcwiQJqGHDVkosbOadD3z9rBdX+KeumGN6Rjx3B pmwh6mHoBxjF+6dc1XOu3GwtOc4OFDbMvj+YRXLjeyaLSYaVpVZkL+Q/s7U91LQAnoYhdxhx8HAx0KpIQk Aw9I2eQuK0FGRTsuR773mW1gYaZoNDAR+Dl+WyLl9F9HHoB81n6NkyJAF5PIzbqtMkBbRpUU043AezTXr mSV+a/UuhDMw=="

}                

}

Response Parameters

 

Name Description Parameter Type Sample Value

MerchantType

Merchant Type String  0088

TraceNo

Trace No Only numbers are allowed  451198

CompanyName

Company Name String  XXXXX

DateTime

Date Time YYYYMMddHHmmss  20170706121213

AccountTitle

Account Title String  NA

AccountType

Account Type String  NA

ResponseCode

Response Code String  58

ResponseDetails

Response Details Array of String  OTP is Invalid

 

 

 

Sample  Response

{

"LinkAccountResponse":

{

"MerchantType": "0088",

"TraceNo": "451198",

"CompanyName": "XXXXX",

"DateTime": "20170706121213",

"AccountTitle": "",

"AccountType": "",

"ResponseCode": "58",

"ResponseDetails": [ "OTP is Invalid" ]

}               

}

Response Code Details


{
"requestId": "3091741309081",
"errorCode": "01",
"errorMessage": "Bad Request - Invalid Authorization Header"
}



{
"requestId": "3091741309081",
"errorCode": "03",
"errorMessage": "Bad Request - Invalid Request Payload"
}



{
"requestId": "3091741309081",
"errorCode": "04",
"errorMessage": "Bad Request - Resource not found"
}



{
"requestId": "3091741309081",
"errorCode": "05",
"errorMessage": "Bad Request - Invalid Access Token"
}
{
    "ResponseCode": "00",
    "ResponseDescription": "Successful",
    "Rrn": "",
    "MobileNumber": "03464991719",
    "Cnic": "3520214402765",
    
}


Try-out Yourself

Header Parameters


Name Values Description
Authorization
(required)

Auth2.0 verification. "Bearer" keyword followed by a space and generated Access Token from OAuth API. Like "Bearer xxxxxxx"

Content-Type
(required)

Content Type application/json is supported

Body Parameters


Name Values Description
Request Body
(required)

Add values in JSON Body

Request Body

HTTP Basic

OAuth 2.0

API Key

Clear Request

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Code examples

  • var request = require('request'),
    oauth_token = "YOUR_ACCESS_TOKEN",
    url = "https://sandbox.jsbl.com/mb/verifyaccount/v0/request"
    auth = "Bearer " + oauth_token;
    request(
    {
    method: 'POST'
    url : url,
    headers : {
    "Authorization" : auth
    }, json : {
    
    "MerchantType" :"",
    "TraceNo" :"",
    "CompanyName" :"",
    "DateTime" :"",
    "TransactionType" :"",
    "MobileNo" :"",
    "Cnic" :"",
    "Reserved1" :"",
    "OtpPin" :"",
    
    
    
    
    } }, function (error, response, body) {
    // TODO: Use the body object to extract the response
    console.log(body)
    }
    )
    
  • <?PHP
    
    $url = 'https://sandbox.jsbl.com/mb/verifyaccount/v0/request';
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_HTTPHEADER, 
    array('Content-Type:application/json','Authorization:Bearer 
    ACCESS_TOKEN')); //setting custom header $curl_post_data = array(
    //Fill in the request parameters with valid values
    'MerchantType' => ' ',
    'TraceNo' => ' '
    'CompanyName' => ' ',
    'DateTime' => ' '
    'TransactionType' => ' ',
    'MobileNo' => ' '
    'Cnic' => ' '
    'Reserved1' => ' '
    'OtpPin' => ' '
    
    
    ); $data_string = json_encode($curl_post_data);
    
  • require 'net/http'
    require 'net/https'
    require 'uri'
    uri = URI('https://sandbox.jsbl.com/mb/verifyaccount/v0/request')
    http = Net::HTTP.new(uri.host, uri.port)
    http.use_ssl = true
    http.verify_mode = OpenSSL::SSL::VERIFY_NONE
    request = Net::HTTP::Get.new(uri)
    request["accept"] = 'application/json'
    request["content-type"] = 'application/json'
    request["authorization"] = 'Bearer '
    request.body = "{
    
    
    \"MerchantType\":\" \",
    \"TraceNo\":\" \"
    \"CompanyName\":\" \",
    \"DateTime\":\" \"
    \"TransactionType\":\" \",
    \"MobileNo\":\" \"
    \"Cnic\":\" \"
    \"Reserved1\":\" \"
    \"OtpPin\":\" \"
    
    
    }"
    response = http.request(request)
    puts response.read_body
    
  • curl -X POST --header "Authorization: 
    Bearer " --header "Content-Type: 
    \"MerchantType\":\" \",
    \"TraceNo\":\" \"
    \"CompanyName\":\" \",
    \"DateTime\":\" \"
    \"TransactionType\":\" \",
    \"MobileNo\":\" \"
    \"Cnic\":\" \"
    \"Reserved1\":\" \"
    \"OtpPin\":\" \"
    }" "https://sandbox.jsbl.com/v2/linkacc-blb"
    
  • OkHttpClient client = new OkHttpClient();
    MediaType mediaType = MediaType.parse("application/json");
    RequestBody body = RequestBody.create(mediaType, "{
    \"MerchantType\":\" \",
    \"TraceNo\":\" \"
    \"CompanyName\":\" \",
    \"DateTime\":\" \"
    \"TransactionType\":\" \",
    \"MobileNo\":\" \"
    \"Cnic\":\" \"
    \"Reserved1\":\" \"
    \"OtpPin\":\" \"
    
    
    }");
    Request request = new Request.Builder()
    .url("https://sandbox.jsbl.com/v2/linkacc-blb")
    .post(body)
    .addHeader("authorization", "Bearer YOUR_OAUTH_TOKEN")
    .addHeader("content-type", "application/json")
    .build();
    Response response = client.newCall(request).execute(); 
    

FAQs

You need to go through the section "How it Works".

Prerequisite(s)

1. Authentication Bear OAuth access token

2. Verify Account for Link Account

Resource Summary

Security

Authentication

Content Type

application/json

Working...