AppZone API Documentation
  • Overview
    • Welcome
    • Getting Started
    • Enterprise User Oauth
  • Account
    • Account API
      • Create Account
      • Account Enquiry
      • Freeze Account
      • Unfreeze Account
      • Check Freeze Status
      • Place Lien on Account
      • Remove Lien on Account
      • Check Lien Status
      • Activate Post-No-Debit on Account
      • Deactivate Post-No-Debit on Account
      • Check Post-No-Debit Status
      • Retrieve BVN Details
      • Create Customer and Account
      • Update Account Tier2
      • Get Bank One Balance Enquiry
      • Generate Account Statement
      • Get Active Savings Accounts by CustomerID
      • Search Transactions
      • Get Transactions
  • Customer
    • Customer API
      • Create Customer
      • Update Customer
      • Get Customer by Account Number
  • Loans
    • Loan API
      • Get Loans By Customer Id
      • Get Loan Repayment Schedule
      • Loan Creation Application 2
      • Get Loan Account Balance 2
  • Account Officer
  • Standing Order
    • Standing Order API
      • Standing Order Creation Application2
      • Get Standing Orders By Debit Account Number
      • Cancel Standing Order
  • Fixed Deposit
    • Fixed Deposits API
      • Create Fixed Deposit Account
      • Get Fixed Deposit Account By Account Number
      • Get Fixed Deposit Account By Liquidation Account
      • Get Fixed Deposit Account By Phone Number
  • Transfers
    • Transfer API
      • Name Enquiry
      • Intra Bank (Local) Fund Transfer
      • Intra Bank Transfer
  • Cards
    • Cards API
      • Retrieve Institution Configurations
      • Card Request
      • Get Customer Cards
      • Hotlist Customer Card
      • Check Card Generation Status
      • Link Card to Customer Account
      • Freeze Cards
      • Unfreeze Cards
      • Add Transaction Limit to Customer Card
      • View Transaction Limit on Customer Card
      • Update Transaction Limit on Customer Card
      • Disable channel for customer card
      • Get Card Delivery Options
      • Re-Enable Channel for Customer Card
  • Overdraft
    • Overdraft API
      • Create Overdraft
      • Get Overdraft Interests
      • Get Overdraft Fees
  • Transactions
    • Transactions API
      • Transaction Status Confirmation
      • Credit Customer Account
      • Debit Customer Account
      • Reversals
  • Bills Payment
    • Bills Payment API
      • Get Commercial Bank
      • Get Billers
      • Get Billers Category
      • Get Payment Items
      • Initiate Bills Payment Transaction
  • Messaging
    • Save Bulk SMS
    • Save Email
Powered by GitBook
On this page
  1. Bills Payment
  2. Bills Payment API

Initiate Bills Payment Transaction

This Processes a bills payment transaction.

To process a bill payment transaction you make a post request by passing Amount, BillerID, BillerName, BillerCategoryID and some other required payload in the request body to the initiate bills payment endpoint

Here is an example of initiate bills payment request with the complete payload in the request body

// Live URL
http://api.mybankone.com/thirdpartyapiservice/apiservice/
BillsPayment/Payment

POST https://staging.mybankone.com/thirdpartyapiservice/apiservice/ BillsPayment/Payment

Request Body

Name
Type
Description

Amount *

String

Transaction amount in naira

BillerID *

String

Biller's ID

BillerName *

String

Biller's Name

BillerCategoryID *

String

Biller Category ID

BillerCategoryName*

String

Biller’s Category Name

PaymentItemID *

String

Payment Item ID

PaymentItemName*

String

Payment Item Name

CustomerID *

String

Customer's ID

CustomerDepositSlip Number *

String

Slip Number

CustomerName*

String

Customer Name

AccountNumber*

String

Customer’s account number

CustomerEmail*

String

Customer’s email address

CustomerPhone*

String

Customer’s phone number

Token *

String

Authentication Key for the request

{
  "Status": "SuccesfulButFeeNotTaken",
 "StatusDescription": "Main Transaction Was Successful But Fee Was Not Taken. Reason is: Invalid Amount",
 "ReferenceID": 0,
 "UniqueIdentifier": 
"020067234510121557250000000000000000000000",
 "IsSuccessFul": true,
 "ResponseMessage": "Main Transaction Was Successful But Fee Was Not Taken. Reason is: Invalid Amount",
 "ResponseCode": "00",
 "Reference": "",
 "SessionID": null,
 "RequestStatus": true,
 "ResponseDescription": "Main Transaction Was Successful But Fee Was Not Taken. Reason is: Invalid Amount",
 "ResponseStatus": null
}
PreviousGet Payment ItemsNextSave Bulk SMS

Last updated 3 years ago