Customer Limit Api

Documentations

Documentations for API

End Points

https://z-sandbox.jsbl.com/zconnect/api/v1/customerLimitApi

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
MTI MTI Mandatory STRING 0200
ProcessingCode ProcessingCode Mandatory STRING 767000
TransmissionDatetime TransmissionDatetime Mandatory STRING 0901160840
SystemsTraceAuditNumber SystemsTraceAuditNumber Mandatory STRING 654888
TimeLocalTransaction TimeLocalTransaction Mandatory STRING 040840
DateLocalTransaction DateLocalTransaction Mandatory STRING 0901
MerchantType MerchantType Mandatory STRING 0088
AccountNumber AccountNumber Mandatory STRING 0302856356
ReceiverAccount ReceiverAccount Optional STRING

Sample Request

{
    "CustomerLimit": {
        "MTI": "0200",
        "ProcessingCode": "767000",
        "TransmissionDatetime": "0901160840",
        "SystemsTraceAuditNumber": "654888",
        "TimeLocalTransaction": "040840",
        "DateLocalTransaction": "0901",
        "MerchantType": "0088",
        "AccountNumber": "03028563561",
        "ReceiverAccount": ""
    }
}

Response Parameters

Name Description Parameter Type Length Sample Value
MTI MTI String 0210
ProcessingCode ProcessingCode String 767000
TransmissionDatetime TransmissionDatetime String 0901160840
SystemsTraceAuditNumber SystemsTraceAuditNumber String 654888
TimeLocalTransaction TimeLocalTransaction String 040840
DateLocalTransaction DateLocalTransaction String 0901
MerchantType MerchantType String 0088
AccountNumber AccountNumber String 03028563561
ReceiverAccount ReceiverAccount String
ResponseCode ResponseCode String 00
ResponseDescription ResponseDescription String SUCCESS
AccountLevel AccountLevel String Level 0
Cnic Cnic String 3740584946279
DailyRemainingDebitLimit DailyRemainingDebitLimit String 25000
DailyRemainingCreditLimit DailyRemainingCreditLimit String 25000
MonthlyRemainingDebitLimit MonthlyRemainingDebitLimit String 49950
MonthlyRemainingCreditLimit MonthlyRemainingCreditLimit String 50000
YearlyRemainingDebitLimit YearlyRemainingDebitLimit String 194676
YearlyRemainingCreditLimit YearlyRemainingCreditLimit String 200000

Response Sample

{
    "CustomerLimit": {
        "MTI": "0210",
        "ProcessingCode": "767000",
        "TransmissionDatetime": "0901160840",
        "SystemsTraceAuditNumber": "654888",
        "TimeLocalTransaction": "040840",
        "DateLocalTransaction": "0901",
        "MerchantType": "0088",
        "AccountNumber": "03028563561",
        "ReceiverAccount": "",
        "ResponseCode": "00",
        "ResponseDescription": "SUCCESS",
        "AccountLevel": "Level 0",
        "Cnic": "3740584946279",
        "DailyRemainingDebitLimit": "25000",
        "DailyRemainingCreditLimit": "25000",
        "MonthlyRemainingDebitLimit": "49950",
        "MonthlyRemainingCreditLimit": "50000",
        "YearlyRemainingDebitLimit": "194676",
        "YearlyRemainingCreditLimit": "200000"
    }
}
curl --location --request POST 'https://z-sandbox.jsbl.com/zconnect/api/v1/customerLimitApi' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'clientId: 364E9806o51K9' \
--header 'clientSecret: eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA' \
--header 'organizationId: 223' \
--data-raw '{
   "CustomerLimit": {
       "MTI": "0200",
       "ProcessingCode": "767000",
       "TransmissionDatetime": "0901160840",
       "SystemsTraceAuditNumber": "654888",
       "TimeLocalTransaction": "040840",
       "DateLocalTransaction": "0901",
       "MerchantType": "0088",
       "AccountNumber": "03028563561",
       "ReceiverAccount": ""
   }
}'
var request = require('request');
var options = {
 'method': 'POST',
 'url': 'https://z-sandbox.jsbl.com/zconnect/api/v1/customerLimitApi',
 'headers': {
   'Content-Type': 'application/json',
   'Accept': 'application/json',
   'clientId': '364E9806o51K9',
   'clientSecret': 'eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA',
   'organizationId': '223'
 },
 body: JSON.stringify({
   "CustomerLimit": {
     "MTI": "0200",
     "ProcessingCode": "767000",
     "TransmissionDatetime": "0901160840",
     "SystemsTraceAuditNumber": "654888",
     "TimeLocalTransaction": "040840",
     "DateLocalTransaction": "0901",
     "MerchantType": "0088",
     "AccountNumber": "03028563561",
     "ReceiverAccount": ""
   }
 })

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

require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://z-sandbox.jsbl.com/zconnect/api/v1/customerLimitApi');
$request->setMethod(HTTP_Request2::METHOD_POST);
$request->setConfig(array(
 'follow_redirects' => TRUE
));
$request->setHeader(array(
 'Content-Type' => 'application/json',
 'Accept' => 'application/json',
 'clientId' => '364E9806o51K9',
 'clientSecret' => 'eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE2OTI2MzcxOTl9.0s3evOaGFm6uyRxSioiXlOffHbZTDIB1zB1xl3ck_IIfxSrsARI9tPiooIOVjVv9rQqUInqtk1odcWtk8V3rFA',
 'organizationId' => '223'
));
$request->setBody('{
\n    "CustomerLimit": {
\n        "MTI": "0200",
\n        "ProcessingCode": "767000",
\n        "TransmissionDatetime": "0901160840",
\n        "SystemsTraceAuditNumber": "654888",
\n        "TimeLocalTransaction": "040840",
\n        "DateLocalTransaction": "0901",
\n        "MerchantType": "0088",
\n        "AccountNumber": "03028563561",
\n        "ReceiverAccount": ""
\n    }
\n}');
try {
 $response = $request->send();
 if ($response->getStatus() == 200) {
   echo $response->getBody();
 }
 else {
   echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
   $response->getReasonPhrase();
 }
}
catch(HTTP_Request2_Exception $e) {
 echo 'Error: ' . $e->getMessage();
}
require "uri"
require "json"
require "net/http"

url = URI("https://z-sandbox.jsbl.com/zconnect/api/v1/customerLimitApi")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

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({
 "CustomerLimit": {
   "MTI": "0200",
   "ProcessingCode": "767000",
   "TransmissionDatetime": "0901160840",
   "SystemsTraceAuditNumber": "654888",
   "TimeLocalTransaction": "040840",
   "DateLocalTransaction": "0901",
   "MerchantType": "0088",
   "AccountNumber": "03028563561",
   "ReceiverAccount": ""
 }
})

response = https.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    \"CustomerLimit\": {\r\n        \"MTI\": \"0200\",\r\n        \"ProcessingCode\": \"767000\",\r\n        \"TransmissionDatetime\": \"0901160840\",\r\n        \"SystemsTraceAuditNumber\": \"654888\",\r\n        \"TimeLocalTransaction\": \"040840\",\r\n        \"DateLocalTransaction\": \"0901\",\r\n        \"MerchantType\": \"0088\",\r\n        \"AccountNumber\": \"03028563561\",\r\n        \"ReceiverAccount\": \"\"\r\n    }\r\n}");
Request request = new Request.Builder()
 .url("https://z-sandbox.jsbl.com/zconnect/api/v1/customerLimitApi")
 .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/v1/customerLimitApi");
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" +
@"    ""CustomerLimit"": {
" + "\n" +
@"        ""MTI"": ""0200"",
" + "\n" +
@"        ""ProcessingCode"": ""767000"",
" + "\n" +
@"        ""TransmissionDatetime"": ""0901160840"",
" + "\n" +
@"        ""SystemsTraceAuditNumber"": ""654888"",
" + "\n" +
@"        ""TimeLocalTransaction"": ""040840"",
" + "\n" +
@"        ""DateLocalTransaction"": ""0901"",
" + "\n" +
@"        ""MerchantType"": ""0088"",
" + "\n" +
@"        ""AccountNumber"": ""03028563561"",
" + "\n" +
@"        ""ReceiverAccount"": """"
" + "\n" +
@"    }
" + "\n" +
@"}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

Response Code Details

{
    "CustomerLimit": {
        "MTI": "0210",
        "ProcessingCode": "767000",
        "TransmissionDatetime": "0901160840",
        "SystemsTraceAuditNumber": "654888",
        "TimeLocalTransaction": "040840",
        "DateLocalTransaction": "0901",
        "MerchantType": "0088",
        "AccountNumber": "03028563561",
        "ReceiverAccount": "",
        "ResponseCode": "00",
        "ResponseDescription": "SUCCESS",
        "AccountLevel": "Level 0",
        "Cnic": "3740584946279",
        "DailyRemainingDebitLimit": "25000",
        "DailyRemainingCreditLimit": "25000",
        "MonthlyRemainingDebitLimit": "49950",
        "MonthlyRemainingCreditLimit": "50000",
        "YearlyRemainingDebitLimit": "194676",
        "YearlyRemainingCreditLimit": "200000"
    }
}
{
    "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