Skip to main content
POST
Create a Bill Order
This feature enables you to receive instant payments via unique control numbers using mobile money or SIM banking (e.g. CRDB).

Request Headers

string
required
Bearer token for authentication. Format: Bearer <token>
string
default:"application/json"
Expected response format. Use application/json.
string
default:"application/json"
Format of the request body. Use application/json.

Request

number
required
The payment amount to be billed.
string
required
A unique reference number for the bill (e.g. FCLORDER12345).
enum<string>
default:"exact"
required
The payment mode for the bill.
  • exact : Locks the bill to the exact amount, user can’t pay below or over the registered amount
  • flexible : Allows partial and over payments. Ideal for installments.
string
required
A short description of what the payment is for (e.g. Solar Installment).
object
Optional key-value pairs for additional context.

Response

boolean
Indicates whether the bill was registered successfully.
string
A human-readable status message.
string
A unique UUID reference for the transaction.
object
Details of the registered bill.