PayPoint
  1. Bill Presentation and Payments - Bill Payments
PayPoint
  • API Access Token
    • Retrieve Access Token
      POST
  • Pre-Paid Airtime Reload
    • Lookup Mobile Number Products
      POST
    • Fetch Airtime Transaction Receipts
      POST
    • Recharge Mobile Number
      POST
    • Fetch Latest Transaction
      POST
    • Lookup Mobile Number Products
      GET
    • Get Airtime Transaction Receipts
      GET
    • Get Transaction
      GET
    • Get Latest Transaction
      GET
    • Get All Products
      GET
    • Get Product Sku By Product ID
      GET
    • Get All Product Skus
      GET
    • Get Product Sku By ID
      GET
    • Get All Products By Operator Id
      GET
    • Get All Products By Country Code
      GET
  • Pay TV Subscription Payments
    • Fetch PayTV Transaction Receipts
      POST
    • Pay TV Subscription
      POST
    • Fetch Latest Pay TV Transaction
      POST
    • Lookup Pay TV Account
      POST
    • Get PayTV Transaction Receipts
      GET
    • Get Pay TV Transaction
      GET
    • Get Latest Pay TV Transaction
      GET
    • Lookup Pay TV Account
      GET
    • Lookup Pay TV Account Copy
      POST
  • Energy Voucher Purchase
    • Fetch Energy Transaction Receipts
    • Fetch Latest Energy Voucher Transaction
    • Purchase Energy Voucher
    • Lookup Energy Bill Payer Account
    • Get Energy Transaction Receipts
    • Get Energy Voucher Transaction
    • Get Latest Energy Voucher Transaction
    • Lookup Energy Bill Payer Account
  • Bill Presentation and Payments - Bill Payments
    • Get Customer Paid Bills
      GET
    • Pay Bill
      POST
    • Pre-Pay Bill Validation
      POST
    • Get Payment Details
      GET
  • Bill Presentation and Payments - Bill Charges
    • Calculate Bill Charges
  • Bill Presentation and Payments - Billers
    • Search Billing Company Details
    • Search Billing Company Details
    • Get Billing Company Details By Id
  • Bill Presentation and Payments - Bill Subscription
    • Subscribe to a Bill
    • Cancel Bill Subscription
  • Bill Presentation and Payments - Bill Enquiry
    • Search Bills By Search Criteria
    • Search Bill By Query Parameters
  1. Bill Presentation and Payments - Bill Payments

Pre-Pay Bill Validation

Testing Env
https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch
Testing Env
https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch
POST
https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch
/api/bill-payments/payments/validate
Maintainer:Not configured
Validations of a Bill before payment

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 details successfully Validated.
Body

🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch/api/bill-payments/payments/validate' \
--header 'X-Request-ID: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
--header 'X-ServiceAccount-ID: 1dce8b76-49d5-4bde-b5dc-09a9fcef8f23' \
--header 'X-Organisation-ID: 9acb4c3f-7f6e-4fd5-a62a-4bcfa8d38e33' \
--header 'Idempotency-Key: fc828f3c-d6ef-4c10-93e4-8c53e3cfd456' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sourcePaymentReference": "6319df06-c695-4ae9-a6dc-06a2d68a1605",
    "debitAccountNumber": "47669210625",
    "paymentAmount": 13.43,
    "paymentDate": "2019-08-24",
    "addReference1": "659102934df",
    "addReference2": "889977",
    "addReference3": "ccc45",
    "addReference4": "Vodafone",
    "addReference5": "post bill",
    "sourceId": "BRANCH-TELLER",
    "debitNarrativeLine1": "Vodafone|Internet",
    "debitNarrativeLine2": "48838",
    "creditNarrativeLine1": "48838",
    "creditNarrativeLine2": "Susannah Wesley",
    "channelId": "IBI",
    "billPaymentDetails": {
        "currency": "string",
        "id": "1",
        "customerIdWithBiller": "GT5482AB",
        "reference": "C4920F94022",
        "billAmount": 12.99,
        "percentCustomerCharge": 35,
        "totalChargeAmount": 0.44,
        "chargeDetails": [
            {
                "chargeCode": "AD",
                "customerChargeAmount": 0.4,
                "originalChargeAmount": 1,
                "taxCode": "VAT",
                "customerTaxAmount": 0.04,
                "originalTaxAmount": 0.1
            }
        ],
        "additionalData": [
            {
                "custom-fields": {
                    "property1": "string",
                    "property2": "string"
                }
            }
        ]
    }
}'
Response Response Example
200 - Example 1
{
    "sourcePaymentReference": "6319df06-c695-4ae9-a6dc-06a2d68a1605"
}
Modified at 2025-07-10 05:30:41
Previous
Pay Bill
Next
Get Payment Details
Built with