Z-Connect

Account Opening L1

Documentations

Documentations for API

End Points

https://z-sandbox.jsbl.com/zconnect/api/v2/accountopeningl1-blb2

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
ProcessingCode	ProcessingCode	Mandatory	STRING	14	AccountOpe
MerchantType	MerchantType	Mandatory	STRING	4	0088
TraceNo	TraceNo	Mandatory	STRING	6	123456
CompanyName	CompanyName	Mandatory	STRING	4	NOVA
DateTime	DateTime	Mandatory	STRING	14	2021102211
CNIC	CNIC	Mandatory	STRING	13	xxxxxxxxxx
FingerIndex	FingerIndex	Mandatory	STRING	1	1
FingerTemplate	FingerTemplate	Mandatory	STRING	500	Rk1SACAyMA
CNICIssuanceDate	CNICIssuanceDate	Mandatory	STRING	8	20191028
MobileNo	MobileNo	Mandatory	STRING	11	xxxxxxxxxx
MobileNetwork	MobileNetwork	Mandatory	STRING	5	UFONE
EmailId	EmailId	Mandatory	STRING	19	xxxxxxxxxx

Sample Request

{
    "AccOpenL1Request": {
        "processingCode": "AccountOpening",
        "merchantType": "0088",
        "traceNo": "123456",
        "companyName": "NOVA",
        "dateTime": "20211022111230",
        "cnic": "xxxxxxxxxxxxx",
        "fingerIndex": "1",
        "fingerTemplate": "",
        "cnicIssuanceDate": "20191028",
        "mobileNo": "xxxxxxxxxxx",
        "mobileNetwork": "UFONE",
        "emailId": "[email protected]"
    }
}

Response Parameters

Name	Description	Parameter Type	Length	Sample Value
processingCode	processingCode	String	14	AccountOpening
MerchantType	MerchantType	String	4	0088
TraceNo	TraceNo	String	6	706055
CompanyName	CompanyName	String	4	NOVA
DateTime	DateTime	String	14	20211022111230
ResponseCode	ResponseCode	String	1	00
ResponseDetails	ResponseDetails	object	14	["Successful"]
citizenNo	citizenNo	String	13	5350403468539
consumerName	consumerName	String	9	Test Data
accountTitle	accountTitle	String	9	Test Data
birthPlace	birthPlace	String	9	Test Data
presentAddress	presentAddress	String	9	Test Data
dateOfBirth	dateOfBirth	String	9	Test Data
gender	gender	String	9	Test Data
motherName	motherName	String	9	Test Data
expiryDate	expiryDate	String	5	47148

Response Sample

{
    "processingCode": "AccountOpening",
    "merchantType": "0088",
    "traceNo": "111488",
    "companyName": "NOVA",
    "dateTime": "20211022111230",
    "responseCode": "00",
    "responseDetails": [
        "Successful"
    ],
    "citizenNo": "xxxxxxxxxxxxx",
    "consumerName": "xxxxxxxxxxx",
    "accountTitle": "xxxxxxxxxxx",
    "birthPlace": "xxxxxxxxxxxx",
    "presentAddress": "xxxxxxxxxx",
    "dateOfBirth": "xxxx-xx-xx",
    "gender": "male",
    "motherName": "xxxxxxxx",
    "expiryDate": "xxxx-xx-xx"
}

Response Code Details

{
    "processingCode": "AccountOpening",
    "merchantType": "0088",
    "traceNo": "111488",
    "companyName": "NOVA",
    "dateTime": "20211022111230",
    "responseCode": "00",
    "responseDetails": [
        "Successful"
    ],
    "citizenNo": "xxxxxxxxxxxxx",
    "consumerName": "xxxxxxxxxxx",
    "accountTitle": "xxxxxxxxxxx",
    "birthPlace": "xxxxxxxxxxxx",
    "presentAddress": "xxxxxxxxxx",
    "dateOfBirth": "xxxx-xx-xx",
    "gender": "male",
    "motherName": "xxxxxxxx",
    "expiryDate": "xxxx-xx-xx"
}

{
    "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