Z-Connect

Debit Card Issuance

Documentations

Documentations for API

End Points

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

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	Sample Value
processingCode	processingCode	Mandatory	STRING	DebitCardI
merchantType	merchantType	Mandatory	STRING	0088
traceNo	traceNo	Mandatory	STRING	782291
companyName	companyName	Mandatory	STRING	KUICKPAY
dateTime	dateTime	Mandatory	STRING	2021010520
mobileNo	mobileNo	Mandatory	STRING	0315024240
terminalId	terminalId	Mandatory	STRING	KUICKPAY
otpPin	otpPin	Optional	STRING
pinType	pinType	Mandatory	STRING	01
transactionType	transactionType	Mandatory	STRING	01
cardProductTypeId	cardProductTypeId	Mandatory	STRING	01
cnic	cnic	Mandatory	STRING	4220112822
cardDescription	cardDescription	Mandatory	STRING	AHSAN
mailingAddress	mailingAddress	Mandatory	STRING	Test1
reserved1	reserved1	Optional	STRING
reserved2	reserved2	Optional	STRING

Sample Request

{
    "DebitCardIssuanceRequest": {
        "processingCode": "DebitCardIssue",
        "merchantType": "0088",
        "traceNo": "782291",
        "companyName": "KUICKPAY",
        "dateTime": "20210105201527",
        "mobileNo": "03150242404",
        "terminalId": "KUICKPAY",
        "otpPin": "",
        "pinType": "01",
        "transactionType": "01",
        "cardProductTypeId": "01",
        "cnic": "4220112822287",
        "cardDescription": "AHSAN",
        "mailingAddress": "Test1",
        "reserved1": "",
        "reserved2": ""
    }
}

Response Parameters

Name	Description	Parameter Type	Sample Value
processingCode	processingCode	String	DebitCardIssue
merchantType	merchantType	String	0088
traceNo	traceNo	String	782291
companyName	companyName	String	KUICKPAY
dateTime	dateTime	String	20210105201527
responseCode	responseCode	String	00
responseDetails	responseDetails	object	["Successful"]

Response Sample

{
    "DebitCardIssuResponse": {
        "processingCode": "DebitCardIssue",
        "merchantType": "0088",
        "traceNo": "782291",
        "companyName": "KUICKPAY",
        "dateTime": "20210105201527",
        "responseCode": "00",
        "responseDetails": [
            "Successful"
        ],
    }
}

Response Code Details

{
    "DebitCardIssuResponse": {
        "processingCode": "DebitCardIssue",
        "merchantType": "0088",
        "traceNo": "782291",
        "companyName": "KUICKPAY",
        "dateTime": "20210105201527",
        "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