Calculate Bill Charges

Testing Env

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

POST

/api/bill-payments/charges/calculate

Maintainer:Not configured

Calculate charges for a bill and fetch total amount.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Bill payment details successfully retrieved after calculating charges.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch/api/bill-payments/charges/calculate' \
--header 'X-Request-ID: 3d8f0c44-d4c7-4c7b-8a67-78e34b4d947e' \
--header 'X-ServiceAccount-ID: 0e92f7e6-8b2a-11ec-b909-0242ac120002' \
--header 'X-Organisation-ID: d321b5af-6e4b-4e47-87d2-7f7eabc84c5f' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerId": "750001",
    "billDetails": {
        "currency": "string",
        "id": "1",
        "customerIdWithBiller": "GT5482AB",
        "reference": "C4920F94022",
        "amount": 12.99,
        "minimumAmount": 12.99,
        "maximumAmount": 12.99,
        "dueDate": "2019-08-24",
        "additionalData": [
            {
                "custom-fields": {
                    "property1": "string",
                    "property2": "string"
                }
            }
        ]
    },
    "sourceId": "BRANCH-TELLER"
}'

Response Example

200 - Example 1

{
    "paymentAmount": 13.43,
    "percentCustomerCharge": 40,
    "billAmount": 12.99,
    "totalChargeAmount": 0.44,
    "chargeDetails": [
        {
            "chargeCode": "AD",
            "customerChargeAmount": 0.4,
            "originalChargeAmount": 1,
            "taxCode": "VAT",
            "customerTaxAmount": 0.04,
            "originalTaxAmount": 0.1
        }
    ]
}

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

Get Payment Details

Search Billing Company Details