Skip to main content

Bill

This is an object representing your bill. You can retrieve it to see the bill of your account.

POST: /v1/b2b/bill

Services​

  • dstv
  • gotv
  • zuku
  • startimes

Request​

    curl -X POST \
     https://api.tupay.africa:8888/v1/b2b/bill/{service} \
     -H 'Authorization: Bearer {token}' \
     -d '"{"account": "{account}", "phone": {phone}}"'
Bill Request
{
    "account": "0733000000",
    "phone": "254722000000"
}
  • account (String): The account
  • phone (String): The customer phone

Response​

Bill Response
{
    "status": 20,
    "response": [
        {
            "account": "1234",
            "balance": 100,
            "currency": "KES",
            "message": "Text"
        }
    ],
    "error": "Failed",
    "due": "2025-01-01"
}
  • status (Integer): The status of the request
  • response (Object): The response containing accounts array
  • error (String): Any bill error
  • due (String): The bill due date