Genrate MPIN

This API will generate the customer MPin to perform a transaction.

GenrateMPIN

POST

GenrateMPIN

 

 

Description

 

This API will generate the customer MPin to perform a transaction.

 

 

Version


V2


Resource URL

https://sandbox.jsbl.com/v2 /generateMpin


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

processingCode

processing Code String GenerateMPIN

merchantType

merchant Type String 0088

traceNo

trace No Only numbers are allowed 211045

companyName

company Name String NOVA

dateTime

date Time YYYYMMddHHmmss 20210105201527

mobileNo

mobile No String 03343638551

terminalId

terminal Id String NOVA

mPin

m Pin String

Mh+Ab+JSNrunmC4rpEak6UaxaxT78C4MVd6wx/yxFV5

udyB0ABKGP/bg6jR3aab3N10NSooAbMP8FFIs3XNzXw

0dxfflUgK7eqz9vj1dDLtQq8yKGEvRrfIiTx8z3zUssiYfBd

oE8kLu1udp1NeG60KRBHhtDs/wytgHxmlGKony4vhnizu

3tBy9/8aeXOsVKw7slDs2kYW1VIvc70mE/y4rTYkacROo

8yWNUKxySo5PKCVEnaMf86dGn4D8uBAV8zKIRNT6F

ZDPlZZAbJMLpSfPdsKHCYwaBGpSpT8o70lWrRaZzpfh

4EPgOIFkRPH4mlgJlXh2RoknZD6kT XsEIw==

confirmMpin

confirm Mpin String

Mh+Ab+JSNrunmC4rpEak6UaxaxT78C4MVd6wx/yxFV5

udyB0ABKGP/bg6jR3aab3N10NSooAbMP8FFIs3XNzXw

0dxfflUgK7eqz9vj1dDLtQq8yKGEvRrfIiTx8z3zUssiYfBd

oE8kLu1udp1NeG60KRBHhtDs/wytgHxmlGKony4vhnizu

3tBy9/8aeXOsVKw7slDs2kYW1VIvc70mE/y4rTYkacRO

o8yWNUKxySo5PKCVEnaMf86dGn4D8uBAV8zKIRNT

6FZDPlZZAbJMLpSfPdsKHCYwaBGpSpT8o70lWrRaZz

pfh4EPgOIFkRPH4mlgJlXh2RoknZD6kT XsEIw==

 

 

Sample  Request

 

{"GenerateMpinRequest":
{"processingCode" : "GenerateMPIN",
"merchantType" : "0088",
"traceNo" : "211045",
"companyName" : "NOVA",
"dateTime" : "20210105201527",
"mobileNo" : "03343638551",
"terminalId" : "NOVA",
"mPin" : "Mh+Ab+JSNrunmC4rpEak6UaxaxT78C4MVd6wx/yxFV5udyB0ABKGP/bg6jR3aab3N10NSooAbMP8FFIs3XNzXw0dxfflUgK7eqz9vj1dDLtQq8yKGEvRrfIiTx8z3zUssiYfBdoE8kLu1udp1NeG60KRBHhtDs/wytgHxmlGKony4vhnizu3tBy9/8aeXOsVKw7slDs2kYW1VIvc70mE/y4rTYkacROo8yWNUKxySo5PKCVEnaMf86dGn4D8uBAV8zKIRNT6FZDPlZZAbJMLpSfPdsKHCYwaBGpSpT8o70lWrRaZzpfh4EPgOIFkRPH4mlgJlXh2RoknZD6kTXsEIw==",
"confirmMpin" : "Mh+Ab+JSNrunmC4rpEak6UaxaxT78C4MVd6wx/yxFV5udyB0ABKGP/bg6jR3aab3N10NSooAbMP8FFIs3XNzXw0dxfflUgK7eqz9vj1dDLtQq8yKGEvRrfIiTx8z3zUssiYfBdoE8kLu1udp1NeG60KRBHhtDs/wytgHxmlGKony4vhnizu3tBy9/8aeXOsVKw7slDs2kYW1VIvc70mE/y4rTYkacROo8yWNUKxySo5PKCVEnaMf86dGn4D8uBAV8zKIRNT6FZDPlZZAbJMLpSfPdsKHCYwaBGpSpT8o70lWrRaZzpfh4EPgOIFkRPH4mlgJlXh2RoknZD6kTXsEIw=="
}
}
 

Response Parameters

 

Name Description Parameter Type Sample Value

processingCode

processing Code String  GenerateMPIN

merchantType

merchant Type String  0088

traceNo

trace No Only numbers are allowed  223055

companyName

company Name String  BIFILER

dateTime

date Time YYYYMMddHHmmss  20210105201527

mobileNetwork

mobile Network String

 UFONE

responseCode

response Code String  00

responseDetails

responseDetails

 

String

 Successful

 

 

Sample  Response

 

{
    "GenerateMpinResponse": {
        "processingCode": "GenerateMPIN",
        "merchantType": "0088",
        "traceNo": "211045",
        "companyName": "NOVA",
        "dateTime": "20210105201527",
        "mobileNetwork": "",
        "responseCode": "88",
        "responseDetails": "["APIGEE RRN Already Exists."]"
    }
}
 

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/v2/generateMpin"
    auth = "Bearer " + oauth_token;
    request(
    {
    method: 'POST'
    url : url,
    headers : {
    "Authorization" : auth
    }, json : {
    
    "processingCode" :"",
    "merchantType" :"",
    "traceNo" :"",
    "companyName" :"",
    "datetime" :"",
    "mobileNo" :"",
    "terminalId" :"",
    "mPin" :"",
    "confirmMpin" :"",
    
    
    
    
    } }, function (error, response, body) {
    // TODO: Use the body object to extract the response
    console.log(body)
    }
    )
    
  • <?PHP
    
    $url = 'https://sandbox.jsbl.com/v2/generateMpin';
    $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
    'processingCode' => ' ',
    'merchantType' => ' '
    'traceNo' => ' ',
    'companyName' => ' '
    'datetime' => ' ',
    'mobileNo' => ' '
    'terminalId' => ' '
    'mPin' => ' '
    'confirmMpin' => ' '
    
    
    ); $data_string = json_encode($curl_post_data);
    
  • require 'net/http'
    require 'net/https'
    require 'uri'
    uri = URI('https://sandbox.jsbl.com/v2/generateMpin')
    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 = "{
    
    
    \"processingCode\":\" \",
    \"merchantType\":\" \"
    \"traceNo\":\" \",
    \"companyName\":\" \"
    \"datetime\":\" \",
    \"mobileNo\":\" \"
    \"terminalId\":\" \"
    \"mPin\":\" \"
    \"confirmMpin\":\" \"
    
    
    }"
    response = http.request(request)
    puts response.read_body
    
  • curl -X POST --header "Authorization: 
    Bearer " --header "Content-Type: 
    \"processingCode\":\" \",
    \"merchantType\":\" \"
    \"traceNo\":\" \",
    \"companyName\":\" \"
    \"datetime\":\" \",
    \"mobileNo\":\" \"
    \"terminalId\":\" \"
    \"mPin\":\" \"
    \"confirmMpin\":\" \"
    }" "https://sandbox.jsbl.com/v2/generateMpin"
    
  • OkHttpClient client = new OkHttpClient();
    MediaType mediaType = MediaType.parse("application/json");
    RequestBody body = RequestBody.create(mediaType, "{
    \"processingCode\":\" \",
    \"merchantType\":\" \"
    \"traceNo\":\" \",
    \"companyName\":\" \"
    \"datetime\":\" \",
    \"mobileNo\":\" \"
    \"terminalId\":\" \"
    \"mPin\":\" \"
    \"confirmMpin\":\" \"
    
    
    }");
    Request request = new Request.Builder()
    .url("https://sandbox.jsbl.com/v2/generateMpin")
    .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

Resource Summary

Security

Authentication

Content Type

application/json

Working...