GET
/
bills
/
{category_id}
/
billers
/
{biller_id}
/
reference
/
{bill_reference}
{
  "status": "00",
  "message": "The process was completed successfully",
  "data": {
    "amount": 240,
    "reference": "310007877416",
    "currency": "NGN",
    "fee": 10,
    "product_info": {
      "category_id": "1",
      "biller_id": "1",
      "product_id": "<string>"
    },
    "payer_info": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "phone": "08012345678"
    },
    "custom_properties": [
      {
        "id": "1",
        "description": "custom_property",
        "type": "string",
        "value": "custom_property"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

connection-id
string

Connection ID for the target bank

idempotency-key
string
required

Unique key to ensure idempotency of the request

signature
string
required

SHA-256 signature of client_secret + ";" + idempotency-key

Path Parameters

category_id
string
required

Category ID

biller_id
string
required

Biller ID

bill_reference
string
required

Bill reference

Response

Bill validation successful

status
string
required
Example:

"00"

message
string
required
Example:

"The process was completed successfully"

data
object
required
I