Title Fetch

Documentations

Documentations for API

End Points

https://z-sandbox.jsbl.com/zconnect/api/v2/titlefetch-blb

Http Method

POST

Header

Name Type Values Description
Accept JSON application/json
Content-Type JSON application/json
clientId String *************
clientSecret String Access-Token Auth2.0 verification
organizationId String 223 Authenticate organization

Request Parameters

Name Description Required Parameter Type Length Sample Value
MerchantType MerchantType Mandatory STRING 4 0088
TraceNo TraceNo Mandatory STRING 6 000031
CompanyName CompanyName Mandatory STRING 4 NOVA
DateTime DateTime Mandatory STRING 14 2021070612
TerminalId TerminalId Mandatory STRING 4 NOVA
SenderMobileNumber SenderMobileNumber Mandatory STRING 11 0332344163
RecieverMobileNumber RecieverMobileNumber Mandatory STRING 11 0332035435
SourceBankIMD SourceBankIMD Mandatory STRING 6 603733
DestinstionBankIMD DestinstionBankIMD Mandatory STRING 6 100196
DestinationAccount DestinationAccount Mandatory STRING 17 0002000001
Amount Amount Mandatory STRING 3 970
Reserved1 Reserved1 Mandatory STRING 2 01

Sample Request

{
    "TitleFetchRequest": {
        "MerchantType": "0088",
        "TraceNo": "000031",
        "CompanyName": "NOVA",
        "DateTime": "20210706121213",
        "TerminalId": "NOVA",
        "SenderMobileNumber": "03323441633",
        "RecieverMobileNumber": "03320354357",
        "SourceBankIMD": "603733",
        "DestinstionBankIMD": "100196",
        "DestinationAccount": "00020000011005325",
        "Amount": "100",
        "Reserved1": "01"
    }
}

Response Parameters

Name Description Parameter Type Length Sample Value
MerchantType MerchantType String 4 0088
TraceNo TraceNo String 6 000031
CompanyName CompanyName String 4 NOVA
DateTime DateTime String 14 20210706121213
SenderMobileNumber SenderMobileNumber String 10 3463564149
RecieverAcountNumber RecieverAcountNumber String 11 81006216594
SenderAccountTitle SenderAccountTitle String 11 UZAIR SABIR
Amount Amount String 3 100
Charges Charges String 1 00
RecieverAccountTitle RecieverAccountTitle String 18 TITLE-1 1006216594
AccountBankName AccountBankName String 4 """"
AccountBranchName AccountBranchName String 4 """"
BenificiaryIBAN BenificiaryIBAN String
SourceBankIMD SourceBankIMD String 6 603733
ResponseCode ResponseCode String 1 00
ResponseDetails ResponseDetails object 20 [ "Successful""]"

Response Sample

{
    "TitleFetchResponse": {
        "merchantType": "0088",
        "TraceNo": "000031",
        "CompanyName": "NOVA",
        "DateTime": "20210706121213",
        "SenderMobileNumber": "03463564149",
        "RecieverAcountNumber": "00081006216594",
        "SenderAccountTitle": "UZAIRSABIR",
        "Amount": "100",
        "Charges": "0.00",
        "RecieverAccountTitle": "TITLE-11006216594",
        "AccountBankName": "{}",
        "AccountBranchName": "{}",
        "BenificiaryIBAN": "null",
        "SourceBankIMD": "603733",
        "ResponseCode": "00",
        "ResponseDetails": ["Successful"]
    }
}
curl --location --request POST 'https://z-sandbox.jsbl.com/zconnect/api/v2/titlefetch-blb' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'clientId: 364E9806o51K9' \
--header 'clientSecret: eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA' \
--header 'organizationId: 223' \
--data-raw '{
"TitleFetchRequest": {
"MerchantType": "0088",
"TraceNo": "000031",
"CompanyName": "NOVA",
"DateTime": "20210706121213",
"TerminalId": "NOVA",
"SenderMobileNumber": "03323441633",
"RecieverMobileNumber": "03320354357",
"SourceBankIMD": "603733",
"DestinstionBankIMD": "100196",
"DestinationAccount": "00020000011005325",
"Amount": "100",
"Reserved1": "01"
}
}'
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://z-sandbox.jsbl.com/zconnect/api/v2/titlefetch-blb',
'headers': {
'Content-Type': 'application/json',
'Accept': 'application/json',
'clientId': '364E9806o51K9',
'clientSecret': 'eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA',
'organizationId': '223'
},
body: JSON.stringify({
"TitleFetchRequest": {
"MerchantType": "0088",
"TraceNo": "000031",
"CompanyName": "NOVA",
"DateTime": "20210706121213",
"TerminalId": "NOVA",
"SenderMobileNumber": "03323441633",
"RecieverMobileNumber": "03320354357",
"SourceBankIMD": "603733",
"DestinstionBankIMD": "100196",
"DestinationAccount": "00020000011005325",
"Amount": "100",
"Reserved1": "01"
}
})



};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});




$curl = curl_init();



curl_setopt_array($curl, array(
CURLOPT_URL => 'https://z-sandbox.jsbl.com/zconnect/api/v2/titlefetch-blb',
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 =>'{
"TitleFetchRequest": {
"MerchantType": "0088",
"TraceNo": "000031",
"CompanyName": "NOVA",
"DateTime": "20210706121213",
"TerminalId": "NOVA",
"SenderMobileNumber": "03323441633",
"RecieverMobileNumber": "03320354357",
"SourceBankIMD": "603733",
"DestinstionBankIMD": "100196",
"DestinationAccount": "00020000011005325",
"Amount": "100",
"Reserved1": "01"
}
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Accept: application/json',
'clientId: 364E9806o51K9',
'clientSecret: eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA',
'organizationId: 223'
),
));



$response = curl_exec($curl);



curl_close($curl);
echo $response;
require "uri"

require "json"

require "net/http"



url = URI("https://z-sandbox.jsbl.com/zconnect/api/v2/titlefetch-blb")



http = Net::HTTP.new(url.host, url.port);

request = Net::HTTP::Post.new(url)

request["Content-Type"] = "application/json"

request["Accept"] = "application/json"

request["clientId"] = "364E9806o51K9"

request["clientSecret"] = "eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA"

request["organizationId"] = "223"

request.body = JSON.dump({

"TitleFetchRequest": {

"MerchantType": "0088",

"TraceNo": "000031",

"CompanyName": "NOVA",

"DateTime": "20210706121213",

"TerminalId": "NOVA",

"SenderMobileNumber": "03323441633",

"RecieverMobileNumber": "03320354357",

"SourceBankIMD": "603733",

"DestinstionBankIMD": "100196",

"DestinationAccount": "00020000011005325",

"Amount": "100",

"Reserved1": "01"

}

})



response = http.request(request)

puts response.read_body
OkHttpClient client = new OkHttpClient().newBuilder()

.build();

MediaType mediaType = MediaType.parse("application/json");

RequestBody body = RequestBody.create(mediaType, "{\r\n \"TitleFetchRequest\": {\r\n \"MerchantType\": \"0088\",\r\n \"TraceNo\": \"000031\",\r\n \"CompanyName\": \"NOVA\",\r\n \"DateTime\": \"20210706121213\",\r\n \"TerminalId\": \"NOVA\",\r\n \"SenderMobileNumber\": \"03323441633\",\r\n \"RecieverMobileNumber\": \"03320354357\",\r\n \"SourceBankIMD\": \"603733\",\r\n \"DestinstionBankIMD\": \"100196\",\r\n \"DestinationAccount\": \"00020000011005325\",\r\n \"Amount\": \"100\",\r\n \"Reserved1\": \"01\"\r\n }\r\n}");

Request request = new Request.Builder()

.url("https://z-sandbox.jsbl.com/zconnect/api/v2/titlefetch-blb")

.method("POST", body)

.addHeader("Content-Type", "application/json")

.addHeader("Accept", "application/json")

.addHeader("clientId", "364E9806o51K9")

.addHeader("clientSecret", "eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA")

.addHeader("organizationId", "223")

.build();

Response response = client.newCall(request).execute();
var client = new RestClient("https://z-sandbox.jsbl.com/zconnect/api/v2/titlefetch-blb");

client.Timeout = -1;

var request = new RestRequest(Method.POST);

request.AddHeader("Content-Type", "application/json");

request.AddHeader("Accept", "application/json");

request.AddHeader("clientId", "364E9806o51K9");

request.AddHeader("clientSecret", "eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA");

request.AddHeader("organizationId", "223");

var body = @"{

" + "\n" +

@" ""TitleFetchRequest"": {

" + "\n" +

@" ""MerchantType"": ""0088"",

" + "\n" +

@" ""TraceNo"": ""000031"",

" + "\n" +

@" ""CompanyName"": ""NOVA"",

" + "\n" +

@" ""DateTime"": ""20210706121213"",

" + "\n" +

@" ""TerminalId"": ""NOVA"",

" + "\n" +

@" ""SenderMobileNumber"": ""03323441633"",

" + "\n" +

@" ""RecieverMobileNumber"": ""03320354357"",

" + "\n" +

@" ""SourceBankIMD"": ""603733"",

" + "\n" +

@" ""DestinstionBankIMD"": ""100196"",

" + "\n" +

@" ""DestinationAccount"": ""00020000011005325"",

" + "\n" +

@" ""Amount"": ""100"",

" + "\n" +

@" ""Reserved1"": ""01""

" + "\n" +

@" }

" + "\n" +

@"}";

request.AddParameter("application/json", body, ParameterType.RequestBody);

IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);

Response Code Details

{
    "TitleFetchResponse": {
        "merchantType": "0088",
        "TraceNo": "000031",
        "CompanyName": "NOVA",
        "DateTime": "20210706121213",
        "SenderMobileNumber": "03463564149",
        "RecieverAcountNumber": "00081006216594",
        "SenderAccountTitle": "UZAIRSABIR",
        "Amount": "100",
        "Charges": "0.00",
        "RecieverAccountTitle": "TITLE-11006216594",
        "AccountBankName": "{}",
        "AccountBranchName": "{}",
        "BenificiaryIBAN": "null",
        "SourceBankIMD": "603733",
        "ResponseCode": "00",
        "ResponseDetails": ["Successful"]
    }
}
{
    "messages": "Bad Request - Invalid Access Token",
    "errorcode": "4001"
}

{
    "messages": "Bad Request - Invalid Request Payload",
    "errorcode": "4002"
}

{
    "messages": "Bad Request - Invalid Authorization Header",
    "errorcode": "4003"
}

{
    "messages": "Something Went Wrong",
    "errorcode": "4004"
}

{
    "messages": "Record Not Found",
    "errorcode": "4005"
}

{
    "messages": "Invalid Client Id\/Secret",
    "errorcode": "4006"
}

{
    "messages": "Bad Request - Invalid Access Token",
    "errorcode": "4007"
}

Try out yourself

Security

X-IBM-Client-Id(apiKey located in header)
X-IBM-Client-Secret(apiKey located in header)
1c48aa28-2614-486f-aa2c-cbc86cc7ab51

Header Parameter

Name Values Description
Content-Type application/json Content Type application/json is supported
Accept application/json Content Type application/json is supported
organizationId xyz You will make a call to the auth-blb api and give it your client ID. You should add the client secret and organisation ID it returns here.
clientId Enter your verified Client Id
clientSecret Enter Your Verified Client Secret

Request Body

Response Body