Xtrempay Api Documentation
- Xtrempay Api Guide
- Authentication
- biometric
- Register UserPOST
- Verify OTP & Issue TokensPOST
- Refresh TokenPOST
- Send Password Reset CodePOST
- Verify Password Reset CodePOST
- Set New PasswordPOST
- Verify Email AddressPOST
- Password Login POST
- Resend Email Verification LinkPOST
- Register User (Email)POST
- Verify OTP For Email & Issue TokensPOST
- Resend OTP to EmailPOST
- Onboarding
- User Account
- Admin
Initiate Bill Payment
Cloud Mock
https://mock.apidog.com/m1/918700-0-default
Cloud Mock
https://mock.apidog.com/m1/918700-0-default
POST
/v1/biller/payment
Maintainer:Xtrempay Devs
Request
Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************or
Body Params application/json
Examples
{
"accountNumber": "1212121212",
"amount": "2565",
"fee": "0",
"total": "2565",
"pin": "1234",
"serviceType": "Cable",
"phoneNumber": "08132069992",
"productCode": "dstv-yanga",
"providerCode": "dstv",
"transactionReference": "955e678f-a985-4cf9-b8cb-f0b140a3cf62"
}Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://mock.apidog.com/m1/918700-0-default/v1/biller/payment' \
--header 'Content-Type: application/json' \
--data-raw '{
"accountNumber": "1212121212",
"amount": "2565",
"fee": "0",
"total": "2565",
"pin": "1234",
"serviceType": "Cable",
"phoneNumber": "08132069992",
"productCode": "dstv-yanga",
"providerCode": "dstv",
"transactionReference": "955e678f-a985-4cf9-b8cb-f0b140a3cf62"
}'Responses
🟢200Success
application/json
Body
Example
{"timestamp":"2025-07-27T05:52:29.088607","status":200,"success":true,"message":"Bill payment Initiated","data":{"transactionReference":"1b9ae2d4-e583-4627-9164-7be563c2779d","status":"SUCCESSFUL","amount":6500,"unit":null,"token":"Token : 11786621902768210244"}}🟠400Invalid input
Modified at 2025-07-27 05:35:01