Z-Connect

Agent Account Opening & Upgrade

Documentations

Documentations for API

End Points

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

Http Method

POST

Header

Name	Type	Values	Description
clientSecret	TEXT	Access-Token	Auth2.0 verification
Accept	JSON	application/json	application/json
Content-Type	JSON	application/json	application/json
clientId	TEXT	*************	*************
organizationId	TEXT	223	Authenticate organization

Request Parameters

Name	Description	Required	Parameter Type	Length	Sample Value

Sample Request

{
    "accountOpeningAgentL0Req": {
        "DTID": 5,
        "ENCT": 1,
        "CREG_STATE": "",
        "CREG_STATE_ID": "",
        "CMOB": "03422142169",
        "PIN": "6tBH5Et3C3b9p7Xzr1YVIQ==",
        "CNIC": "4250130646839",
        "BIRTH_PLACE": "KARACHI SHARKI KARACHI SHARKI",
        "RESP": "",
        "CNAME": "AHSAN MEHMOOD",
        "MOTHER_MAIDEN": "SHEHNAZ PARVEEN",
        "CDOB": "1992-06-23",
        "CNIC_STATUS": "",
        "CNIC_EXP": "2022-12-31",
        "PRESENT_ADDR": "HOUSE NUMBER R-83 MOHALA PAK KOUSAR TOWN MALIR TOUSEE KARACHI SHARKI",
        "PRESENT_CITY": "",
        "PERMANENT_ADDR": "HOUSE NUMBER R-83 MOHALA PAK KOUSAR TOWN MALIR TOUSEE KARACHI SHARKI",
        "PERMANENT_CITY": "",
        "ACTITLE": "AHSAN MEHMOOD",
        "GENDER": "male",
        "FATHER_HUSBND_NAME": "",
        "IS_CNIC_SEEN": 1,
        "DEPOSIT_AMT_FLAG": 0,
        "DEPOSIT_AMT": "",
        "AMOB": "03463564149",
        "PID": 2510763,
        "IS_BVS_ACCOUNT": 1,
        "CUST_ACC_TYPE": 2,
        "TRXID": "",
        "CUST_MOB_NETWORK": "Telenor",
        "IS_HRA": "",
        "NOKMOB": "",
        "TRX_PUR": "",
        "OCCUPATION": "",
        "ORG_LOC1": "",
        "ORG_LOC2": "",
        "ORG_LOC3": "",
        "ORG_LOC4": "",
        "ORG_LOC5": "",
        "ORG_REL1": "",
        "ORG_REL2": "",
        "ORG_REL3": "",
        "ORG_REL4": "",
        "ORG_REL5": ""
    }
}

Response Parameters

Name	Description	Parameter Type	Length	Sample Value

Response Sample

{
    "accountOpeningAgentL0Res": {
        "id": "-1",
        "errors": [
            {
                "code": "9096",
                "level": "2",
                "message": "CNIC is expired, please use valid CINC to open account.",
                "THIRD_PARTY_TRANSACTION_ID": "",
                "nadraSessionId": ""
            }
        ]
    }
}

Response Code Details

{
    "accountOpeningAgentL0Res": {
        "id": "-1",
        "errors": [
            {
                "code": "9096",
                "level": "2",
                "message": "CNIC is expired, please use valid CINC to open account.",
                "THIRD_PARTY_TRANSACTION_ID": "",
                "nadraSessionId": ""
            }
        ]
    }
}

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

{
    "accountOpeningAgentL0Req": {
        "DTID": 5,
        "ENCT": 1,
        "CREG_STATE": "",
        "CREG_STATE_ID": "",
        "CMOB": "03422142169",
        "PIN": "6tBH5Et3C3b9p7Xzr1YVIQ==",
        "CNIC": "4250130646839",
        "BIRTH_PLACE": "KARACHI SHARKI KARACHI SHARKI",
        "RESP": "",
        "CNAME": "AHSAN MEHMOOD",
        "MOTHER_MAIDEN": "SHEHNAZ PARVEEN",
        "CDOB": "1992-06-23",
        "CNIC_STATUS": "",
        "CNIC_EXP": "2022-12-31",
        "PRESENT_ADDR": "HOUSE NUMBER R-83 MOHALA PAK KOUSAR TOWN MALIR TOUSEE KARACHI SHARKI",
        "PRESENT_CITY": "",
        "PERMANENT_ADDR": "HOUSE NUMBER R-83 MOHALA PAK KOUSAR TOWN MALIR TOUSEE KARACHI SHARKI",
        "PERMANENT_CITY": "",
        "ACTITLE": "AHSAN MEHMOOD",
        "GENDER": "male",
        "FATHER_HUSBND_NAME": "",
        "IS_CNIC_SEEN": 1,
        "DEPOSIT_AMT_FLAG": 0,
        "DEPOSIT_AMT": "",
        "AMOB": "03463564149",
        "PID": 2510763,
        "IS_BVS_ACCOUNT": 1,
        "CUST_ACC_TYPE": 2,
        "TRXID": "",
        "CUST_MOB_NETWORK": "Telenor",
        "IS_HRA": "",
        "NOKMOB": "",
        "TRX_PUR": "",
        "OCCUPATION": "",
        "ORG_LOC1": "",
        "ORG_LOC2": "",
        "ORG_LOC3": "",
        "ORG_LOC4": "",
        "ORG_LOC5": "",
        "ORG_REL1": "",
        "ORG_REL2": "",
        "ORG_REL3": "",
        "ORG_REL4": "",
        "ORG_REL5": ""
    }
}