Search Billing Company Details

Testing Env

https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch

POST

/api/bill-payments/billers/search

Maintainer:Not configured

Retrieve billing company details associated with the customer using POST request

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Billing company details successfully retrieved.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch/api/bill-payments/billers/search' \
--header 'X-Request-ID: b3f66b64-9c3a-4f47-bcb3-abb6db25a197' \
--header 'X-ServiceAccount-ID: a12fa173-322b-4e83-b8f4-9247b81beac2' \
--header 'X-Organisation-ID: c5e1a60f-61c4-4d44-a7a6-40c80431c77d' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerId": "string",
    "companyId": "string",
    "classificationType": "string",
    "classificationValue": "string",
    "customerIdOptional": "string",
    "companyIdOptional": "string",
    "classificationTypeOptional": "string",
    "classificationValueOptional": "string"
}'

Response Example

200 - Example 1

{
    "items": [
        {
            "id": "1",
            "companyCode": "550001",
            "companyDescription": "Airtel",
            "serviceProvided": "TELECOM",
            "serviceProvidedDescription": "Mobile",
            "category": "POSTPAID",
            "categoryDescription": "Post paid",
            "subCategory": "2GBDownload",
            "subCategoryDescription": "2GB per day",
            "furtherSubCategory": "Plan1299",
            "furtherSubCategoryDescription": "Plan 1299",
            "amountInputMethod": "CUSTOMER-ENTERED",
            "supportedCurrency": "EUR",
            "isPartialAllowed": false,
            "minimumAmountAllowed": 100,
            "isExcessAllowed": false,
            "maxAmountAllowed": 100,
            "additionalDataRequired": [
                {
                    "fieldName": "BILLALPHA1",
                    "fieldType": "ALPHANUMERIC",
                    "isMandatory": false,
                    "fieldDescription": "Consumer No"
                }
            ]
        }
    ],
    "links": {
        "self": {
            "href": "string",
            "templated": true
        },
        "first": {
            "href": "string",
            "templated": true
        },
        "next": {
            "href": "string",
            "templated": true
        },
        "prev": {
            "href": "string",
            "templated": true
        }
    }
}

Modified at 2025-07-10 05:30:41

Calculate Bill Charges

Search Billing Company Details