Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-26294473.4 KB

Generates a BillPay Control Number for a specific bill, transaction or invoice

post/billpay/create-order-control-number

Request body

billDescriptionstring

Description of the bill

billPaymentMode'ALLOW_PARTIAL_AND_OVER_PAYMENT' | 'EXACT'

Payment mode for the bill. Applied only when billAmount is set

billAmountnumber

Amount of the bill

billReferencestring

Custom bill reference (alphanumeric). If provided, this will be the number used to make payment. If not provided, the system auto-generates one

Example request

{
  "billDescription": "Water Bill - July 2024",
  "billAmount": 90900
}

Response

Successfully generated BillPay Control Number

updatedAtstring date-time

Last updated timestamp

createdAtstring date-time

Creation timestamp

idstring

Payout ID

orderReferencestring

Associated order reference

amountstring

Payout amount

currencystring

Currency code

feestring

Transaction fee

status'SUCCESS' | 'PROCESSING' | 'PENDING' | 'FAILED' | 'REFUNDED' | 'REVERSED'

Payout status

channel'BANK TRANSFER' | 'MOBILE MONEY'

Payout channel

channelProviderstring

Name of the payout channel provider

transferType'ACH' | 'RTGS'

Transfer type - when applicable

notesstring

Additional notes if available

clientIdstring

Application Client ID associated with the payout