QBills

Developer API

QBills Developer API Docs

Integrate bill payments and digital services into your product with clean endpoints, clear statuses, and secure workflows. This page is a starter documentation hub—replace the examples with your live API spec when ready.

Quick links

Create merchant account Contact support

Overview

The QBills API lets merchants initiate service purchases (airtime/data, electricity, cable TV, gift cards), track statuses, and receive updates through webhooks.

Authentication

Authenticate using an API key.

Example
Authorization: Bearer YOUR_API_KEY

Transactions

Create a transaction with a unique reference and check status anytime.

Create a transaction
POST /api/v1/transactions
Authorization: Bearer YOUR_API_KEY

{
  "service": "electricity",
  "amount": 1000,
  "customer": "...",
  "reference": "QB-ORDER-000123"
}

// Response
{
  "status": "success",
  "reference": "QB-ORDER-000123",
  "provider_status": "delivered"
}

Webhooks

Receive funding and delivery updates in real-time.

Example webhook payload
{
  "event": "transaction.updated",
  "data": {
    "reference": "QB-ORDER-000123",
    "status": "success",
    "provider_status": "delivered"
  }
}

Errors

Errors use consistent codes/messages to simplify debugging.

  • 401 – Invalid API key
  • 422 – Validation error
  • 500 – Server error