POST Billspayments/Billsadvice

Request Information

URI Parameters

None.

Body Parameters

Name	Type	Additional information
transactionCountry	string	None.
ipAddress	string	None.
vendType	string	None.
username	string	None.
paymentname	string	None.
billerName	string	None.
narration	string	None.
billerid	string	Required
telco	string	None.
Source	string	Required
AccountNo	string	Required Matching regular expression pattern: ^\d{10}$
customerId	string	Required
customerMobile	string	None.
customerEmail	string	None.
deliveryEngine	string	None.
amount	decimal number	Required Range: inclusive between 0.01 and 1.79769313486232E+308
amountInKobo	string	None.
requestReference	string	None.
CustomerName	string	None.
paymentCode	string	Required
SaveBeneficiary	boolean	None.
AuthRequest	TransAuthRequest	Required
UseLoyaltyPoints	boolean	None.

Request Formats

application/json, text/json

Sample:

{
  "transactionCountry": "sample string 1",
  "ipAddress": "sample string 2",
  "vendType": "sample string 3",
  "username": "sample string 4",
  "paymentname": "sample string 5",
  "billerName": "sample string 6",
  "narration": "sample string 7",
  "billerid": "sample string 8",
  "telco": "sample string 9",
  "Source": "sample string 10",
  "AccountNo": "sample string 11",
  "customerId": "sample string 12",
  "customerMobile": "sample string 13",
  "customerEmail": "sample string 14",
  "deliveryEngine": "sample string 15",
  "amount": 16.0,
  "amountInKobo": "1600",
  "requestReference": "sample string 17",
  "CustomerName": "sample string 18",
  "paymentCode": "sample string 19",
  "SaveBeneficiary": true,
  "AuthRequest": {
    "TPin": "sample string 1",
    "SecondFa": "sample string 2",
    "SecondFaType": "sample string 3",
    "CardAccountNumber": "sample string 4",
    "Enforce2FA": true
  },
  "UseLoyaltyPoints": true
}

Response Information

Resource Description

BillsPaymentAdviceResponse

Name	Type	Additional information
ID	integer	None.
transactionRef	string	None.
responseCode	string	None.
responseMessage	string	None.
responseCodeGrouping	string	None.
MiscData	string	None.
PIN	string	None.
TransactionReference	string	None.
TRDRequestPayload	string	None.
TRDResponsePayload	string	None.
TRDResponseCode	string	None.
TRDResponseMessage	string	None.
TRDRequestTime	date	None.
TRDResponseTime	date	None.
T24Reference	string	None.
T24RequestPayload	string	None.
T24RequestResponse	string	None.
T24RequestTime	date	None.
T24ResponseTime	date	None.
T24ResponseCode	string	None.
T24ResponseMessage	string	None.
FTReversalStatusCode	string	None.
FTReversalStatusMsg	string	None.
FTReversalRequestDate	string	None.
rechargePIN	string	None.

Response Formats

application/json, text/json

Sample:

{
  "ID": 1,
  "transactionRef": "sample string 2",
  "responseCode": "sample string 3",
  "responseMessage": "sample string 4",
  "responseCodeGrouping": "sample string 5",
  "MiscData": "sample string 6",
  "PIN": "sample string 7",
  "TransactionReference": "sample string 8",
  "TRDRequestPayload": "sample string 9",
  "TRDResponsePayload": "sample string 10",
  "TRDResponseCode": "sample string 11",
  "TRDResponseMessage": "sample string 12",
  "TRDRequestTime": "2026-04-17T09:29:34.886381+01:00",
  "TRDResponseTime": "2026-04-17T09:29:34.886381+01:00",
  "T24Reference": "sample string 13",
  "T24RequestPayload": "sample string 14",
  "T24RequestResponse": "sample string 15",
  "T24RequestTime": "2026-04-17T09:29:34.9020111+01:00",
  "T24ResponseTime": "2026-04-17T09:29:34.9020111+01:00",
  "T24ResponseCode": "sample string 16",
  "T24ResponseMessage": "sample string 17",
  "FTReversalStatusCode": "sample string 18",
  "FTReversalStatusMsg": "sample string 19",
  "FTReversalRequestDate": "sample string 20",
  "rechargePIN": "sample string 21"
}