PNG Verification

This API is used to verify PNG connections using either Consumer ID or Business Partner Number. It supports both individual and business connections.

png_verification

POST https://secctrl.tutelar.io/api/v1/services/business_profile/png_verification

Sample Request Body

Body

Type

Mandatory

Dependency Condition

Description

consumerId

string

Optional

Either consumerId or businessPartnerNumber is Required

Consumer Id of PNG Connection

businessPartnerNumber

string

Optional

Either consumerId or businessPartnerNumber is Required

Business Partner Number of PNG Connection

serviceProvider

string

Yes

Service Provider of PNG Connection

consent

string

Yes

Consent

Sample Post Parameters

{
    "consent": "Y",
    "consumerId": "",
    "businessPartnerNumber": "1000031234",
    "serviceProvider": "IG"
}

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "bde63acb-1e76-4117-a21d-c75192f5744d",
    "status": "completed",
    "result": {
        "customerName": "URBA XXXX",
        "email": "",
        "billNumber": "100000031234",
        "billDate": "",
        "dueDate": "07/05/2026",
        "billAmount": "0.00",
        "customerAddress": ""
    },
    "requested_at": "2026-06-05T06:08:09.675Z",
    "completed_at": "2026-06-05T06:08:11.823Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "d1bbfb97-c82f-475d-b666-07e7b258f3da",
    "status": "in_progress",
    "requested_at": "2026-06-05T06:08:09.675Z",
}

{
    "success": false,
    "code": 400,
    "message": "Invalid Consumer Id",
    "error": {
        "message": "Invalid Consumer Id",
        "field": "consumerId",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid Business Partner Number",
    "error": {
        "message": "Invalid Business Partner Number",
        "field": "businessPartnerNumber",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid Service Provider",
    "error": {
        "message": "Invalid Service Provider",
        "field": "serviceProvider",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Service Provider Number should not be empty",
    "error": {
        "message": "Service Provider should not be empty",
        "field": "serviceProvider",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Either Consumer Id or Business Partner Number is required",
    "error": {
        "message": "Either Consumer Id or Business Partner Number is required",
        "code": "BAD_REQUEST"
    }
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "548025c4-9528-4502-958a-5b1226a63a60",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2026-06-05T06:08:16.129Z",
    "completed_at": "2026-06-05T06:08:17.541Z"
}

Get details

GET https://secctrl.tutelar.io/api/v1/services/business_profile/png_verification

Query parameters description is given below,

Query Parameter

Type

Is Mandatory

Description

reference_id

String

Yes

Document reference id

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "bde63acb-1e76-4117-a21d-c75192f5744d",
    "status": "completed",
    "result": {
        "customerName": "URBA XXXXX",
        "email": "",
        "billNumber": "100000031234",
        "billDate": "",
        "dueDate": "07/05/2026",
        "billAmount": "0.00",
        "customerAddress": ""
    },
    "requested_at": "2026-06-05T06:08:09.675Z",
    "completed_at": "2026-06-05T06:08:11.823Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "d1bbfb97-c82f-475d-b666-07e7b258f3da",
    "status": "in_progress",
    "requested_at": "2026-06-05T06:08:09.675Z",
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "548025c4-9528-4502-958a-5b1226a63a60",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2026-06-05T06:08:16.129Z",
    "completed_at": "2026-06-05T06:08:17.541Z"
}

PreviousTIN Verification NextCredit Bureau Check

Last updated 1 month ago