Z-Connect

IBFT

Documentations

Documentations for API

End Points

https://z-sandbox.jsbl.com/zconnect/api/v2/ibft-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	515407
CompanyName	CompanyName	Mandatory	STRING	4	NOVA
DateTime	DateTime	Mandatory	STRING	14	2021070612
TerminalId	TerminalId	Mandatory	STRING	4	NOVA
SenderMobileNumber	SenderMobileNumber	Mandatory	STRING	11	xxxxxxxxxx
RecieverMobileNumber	RecieverMobileNumber	Mandatory	STRING	11	xxxxxxxxxx
SourceBankIMD	SourceBankIMD	Mandatory	STRING	6	603733
DestinstionBankIMD	DestinstionBankIMD	Mandatory	STRING	6	100196
DestinationAccount	DestinationAccount	Mandatory	STRING	17	0002000001
Amount	Amount	Mandatory	STRING	3	100
OtpPin	OtpPin	Mandatory	STRING	344	ZarH77yWmg
MPin	MPin	Mandatory	STRING	0
PurposeOfPayment	PurposeOfPayment	Mandatory	STRING	11	CAR LIFTIN
SenderAcountTitle	SenderAcountTitle	Mandatory	STRING	7	ALI ALI
RecieverAccountTitle	RecieverAccountTitle	Mandatory	STRING	18	TAIMOOR AL
ToBankName	ToBankName	Mandatory	STRING	11	MODEL BAN
ToBranchName	ToBranchName	Mandatory	STRING	15	LANDHI KA
BenificiaryIBAN	BenificiaryIBAN	Mandatory	STRING	0
Reserved1	Reserved1	Mandatory	STRING	2	02

Sample Request

{
    "IBFTRequest": {
        "MerchantType": "0088",
        "TraceNo": "515407",
        "CompanyName": "NOVA",
        "DateTime": "20210706121213",
        "TerminalId": "NOVA",
        "SenderMobileNumber": "xxxxxxxxxxx",
        "RecieverMobileNumber": " xxxxxxxxxxx ",
        "SourceBankIMD": "603733",
        "DestinstionBankIMD": "100196",
        "DestinationAccount": "00020000011005325",
        "Amount": "100",
        "OtpPin": "01",
        "MPin": "",
        "PurposeOfPayment": "CAR LIFTING",
        "SenderAcountTitle": "ALI ALI",
        "RecieverAccountTitle": "TAIMOOR ALI 1-LINK",
        "ToBankName": "MODEL BANK",
        "ToBranchName": "LANDHI KARACHI",
        "BenificiaryIBAN": "",
        "Reserved1": "01"
    }
}

Response Parameters

Name	Description	Parameter Type	Length	Sample Value
MerchantType	MerchantType	String	4	0088
TraceNo	TraceNo	String	6	515407
CompanyName	CompanyName	String	4	NOVA
DateTime	DateTime	String	14	20210706121213
ResponseCode	ResponseCode	String	1	00
ResponseDetails	ResponseDetails	object	14	["Successful"]

Response Sample

{
    "IBFTResponse": {
        "MerchantType": "0088",
        "TraceNo": "515407",
        "CompanyName": "NOVA",
        "DateTime": "20210706121213",
        "ResponseCode": "00",
        "ResponseDetails": ["Successful"]
    }
}

curl --location --request POST 'https://z-sandbox.jsbl.com/zconnect/api/v2/ibft-blb' \

--header 'Content-Type: application/json' \

--header 'Accept: application/json' \

--header 'clientId: 364E9806o51K9' \

--header 'clientSecret: eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA' \

--header 'organizationId: 223' \

--data-raw '{

    "IBFTRequest": {

        "MerchantType": "0088",

        "TraceNo": "515407",

        "CompanyName": "NOVA",

        "DateTime": "20210706121213",

        "TerminalId": "NOVA",

        "SenderMobileNumber": "xxxxxxxxxxx",

        "RecieverMobileNumber": " xxxxxxxxxxx ",

        "SourceBankIMD": "603733",

        "DestinstionBankIMD": "100196",

        "DestinationAccount": "00020000011005325",

        "Amount": "100",

        "OtpPin": "01",

        "MPin": "",

        "PurposeOfPayment": "CAR LIFTING",

        "SenderAcountTitle": "ALI ALI",

        "RecieverAccountTitle": "TAIMOOR ALI 1-LINK",

        "ToBankName": "MODEL BANK",

        "ToBranchName": "LANDHI KARACHI",

        "BenificiaryIBAN": "",

        "Reserved1": "01"

    }

}'

var request = require('request');

var options = {

  'method': 'POST',

  'url': 'https://z-sandbox.jsbl.com/zconnect/api/v2/ibft-blb',

  'headers': {

    'Content-Type': 'application/json',

    'Accept': 'application/json',

    'clientId': '364E9806o51K9',

    'clientSecret': 'eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA',

    'organizationId': '223'

  },

  body: JSON.stringify({

    "IBFTRequest": {

      "MerchantType": "0088",

      "TraceNo": "515407",

      "CompanyName": "NOVA",

      "DateTime": "20210706121213",

      "TerminalId": "NOVA",

      "SenderMobileNumber": "xxxxxxxxxxx",

      "RecieverMobileNumber": " xxxxxxxxxxx ",

      "SourceBankIMD": "603733",

      "DestinstionBankIMD": "100196",

      "DestinationAccount": "00020000011005325",

      "Amount": "100",

      "OtpPin": "01",

      "MPin": "",

      "PurposeOfPayment": "CAR LIFTING",

      "SenderAcountTitle": "ALI ALI",

      "RecieverAccountTitle": "TAIMOOR ALI 1-LINK",

      "ToBankName": "MODEL BANK",

      "ToBranchName": "LANDHI KARACHI",

      "BenificiaryIBAN": "",

      "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/ibft-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 =>'{

    "IBFTRequest": {

        "MerchantType": "0088",

        "TraceNo": "515407",

        "CompanyName": "NOVA",

        "DateTime": "20210706121213",

        "TerminalId": "NOVA",

        "SenderMobileNumber": "xxxxxxxxxxx",

        "RecieverMobileNumber": " xxxxxxxxxxx ",

        "SourceBankIMD": "603733",

        "DestinstionBankIMD": "100196",

        "DestinationAccount": "00020000011005325",

        "Amount": "100",

        "OtpPin": "01",

        "MPin": "",

        "PurposeOfPayment": "CAR LIFTING",

        "SenderAcountTitle": "ALI ALI",

        "RecieverAccountTitle": "TAIMOOR ALI 1-LINK",

        "ToBankName": "MODEL BANK",

        "ToBranchName": "LANDHI KARACHI",

        "BenificiaryIBAN": "",

        "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/ibft-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({

  "IBFTRequest": {

    "MerchantType": "0088",

    "TraceNo": "515407",

    "CompanyName": "NOVA",

    "DateTime": "20210706121213",

    "TerminalId": "NOVA",

    "SenderMobileNumber": "xxxxxxxxxxx",

    "RecieverMobileNumber": " xxxxxxxxxxx ",

    "SourceBankIMD": "603733",

    "DestinstionBankIMD": "100196",

    "DestinationAccount": "00020000011005325",

    "Amount": "100",

    "OtpPin": "01",

    "MPin": "",

    "PurposeOfPayment": "CAR LIFTING",

    "SenderAcountTitle": "ALI ALI",

    "RecieverAccountTitle": "TAIMOOR ALI 1-LINK",

    "ToBankName": "MODEL BANK",

    "ToBranchName": "LANDHI KARACHI",

    "BenificiaryIBAN": "",

    "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    \"IBFTRequest\": {\r\n        \"MerchantType\": \"0088\",\r\n        \"TraceNo\": \"515407\",\r\n        \"CompanyName\": \"NOVA\",\r\n        \"DateTime\": \"20210706121213\",\r\n        \"TerminalId\": \"NOVA\",\r\n        \"SenderMobileNumber\": \"xxxxxxxxxxx\",\r\n        \"RecieverMobileNumber\": \" xxxxxxxxxxx \",\r\n        \"SourceBankIMD\": \"603733\",\r\n        \"DestinstionBankIMD\": \"100196\",\r\n        \"DestinationAccount\": \"00020000011005325\",\r\n        \"Amount\": \"100\",\r\n        \"OtpPin\": \"01\",\r\n        \"MPin\": \"\",\r\n        \"PurposeOfPayment\": \"CAR LIFTING\",\r\n        \"SenderAcountTitle\": \"ALI ALI\",\r\n        \"RecieverAccountTitle\": \"TAIMOOR ALI 1-LINK\",\r\n        \"ToBankName\": \"MODEL BANK\",\r\n        \"ToBranchName\": \"LANDHI KARACHI\",\r\n        \"BenificiaryIBAN\": \"\",\r\n        \"Reserved1\": \"01\"\r\n    }\r\n}");

Request request = new Request.Builder()

  .url("https://z-sandbox.jsbl.com/zconnect/api/v2/ibft-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/ibft-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" +

@"    ""IBFTRequest"": {

" + "\n" +

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

" + "\n" +

@"        ""TraceNo"": ""515407"",

" + "\n" +

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

" + "\n" +

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

" + "\n" +

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

" + "\n" +

@"        ""SenderMobileNumber"": ""xxxxxxxxxxx"",

" + "\n" +

@"        ""RecieverMobileNumber"": "" xxxxxxxxxxx "",

" + "\n" +

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

" + "\n" +

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

" + "\n" +

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

" + "\n" +

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

" + "\n" +

@"        ""OtpPin"": ""01"",

" + "\n" +

@"        ""MPin"": """",

" + "\n" +

@"        ""PurposeOfPayment"": ""CAR LIFTING"",

" + "\n" +

@"        ""SenderAcountTitle"": ""ALI ALI"",

" + "\n" +

@"        ""RecieverAccountTitle"": ""TAIMOOR ALI 1-LINK"",

" + "\n" +

@"        ""ToBankName"": ""MODEL BANK"",

" + "\n" +

@"        ""ToBranchName"": ""LANDHI KARACHI"",

" + "\n" +

@"        ""BenificiaryIBAN"": """",

" + "\n" +

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

" + "\n" +

@"    }

" + "\n" +

@"}";

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

IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);

Response Code Details

{
    "IBFTResponse": {
        "MerchantType": "0088",
        "TraceNo": "515407",
        "CompanyName": "NOVA",
        "DateTime": "20210706121213",
        "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