PAYBETA API
    PAYBETA API
    • UTILITY BILL PAYMENT API
    • Airtime
      • Providers
        GET
      • Payment
        POST
    • Data Bundle
      • Get Providers
        GET
      • Get Data Bundles
        POST
      • Payment
        POST
    • Cable TV
      • Get Providers
        GET
      • Get Bouquet
        POST
      • Validate Account
        POST
      • Payment
        POST
    • Electricity
      • Get Providers
        GET
      • Validate Account
        POST
      • Payment
        POST
    • Showmax
      • Get Bouquets
        GET
      • Payment
        POST
    • Gaming
      • Get Providers
        GET
      • Validate Account
        POST
      • Payment
        POST
    • Wallet
      • Balance
        GET
    • Transaction Query
      POST

    UTILITY BILL PAYMENT API

    paybeta-banner.png

    Get Started#

    Paybeta API is a RESTful API that allows you to integrate bills payment services available on the platform.
    Architecture: REST
    Data Format: JSON
    Commission Rate Here

    Getting access to the APIs#

    Sign up and start building#

    To register developer account click here
    Create your account by providing the necessary details
    Join our Slack community Here.
    Request for API access by reaching out to support@paybeta.ng
    Your account manager will request for necessary documentations and KYC

    General API information#

    NOTE: You must be enabled for Live before you can make live Api call to our production endpoints.
    BASE URL: The base URL for the API is as seen below
    https://api.paybeta.ng

    Authentication#

    We expose the endpoint over HTTPS and we require that API Key Authorization header be sent with every request to the Paybeta API interface. The API key Authentication requires you send in the header P-API-KEY as key and then the value is your api key copied from console on all API calls.
    Authentication Example:

    Request Headers#

    Accept: This field is required & must always be set to application/json
    Content-Type: This field is required & must always be set to application/json
    P-API-KEY: All endpoints require a authentication to authorise the request.

    Response Definitions#

    FieldTypeDescription
    statusstringThis can be 'successful', 'failed' or 'pending'
    messagestringAdditional details on the request status
    dataobjectContains relevant response data for the transaction. E.g For EPINS, it will contain the pins, for electricity, it will contain the electricity values such as token, unit, amount, etc.

    Meet Paybeta Bill Payment:#

    Bills Payment refers to all forms of utility payments online. This includes, but is not limited to, electricity, airtime, data, cable TV subscriptions, taxes, and government levies. Paybeta Bills Payment is an easy-to-integrate API product that helps software developers embed online bills payment natively into their products.
    With our Bills Payment API, you get instant access to 9 out of 11 Discos in Nigeria, MTN, 9Mobile, Airtel, GLO, StarTimes, DSTV, and GOTV. When live, your customers can buy credits or subscription units on your platform via our API within minutes.
    Paybeta takes care of all the complexities and background relationships with the service providers.
    flow.png

    What services can you offer?#

    There are four ebills services on Paybeta Bills Payment - electricity bills, airtime, Internet data, and cable TV subscriptions.
    For electricity, we support Eko Disco, Jos Disco, Kano Disco, Abuja Disco, Kaduna Disco, Enugu Disco, Ikeja Disco, Ibadan Disco, Porthacourt Disco, Benin Disco and Aba Disco. We do not currently offer Yola Disco & Benin Disco at the moment.
    For airtime/data, we support all major telcos - MTN, Airtel, GLO and 9Mobile. For cable TV subscriptions, we support StarTimes, DSTV, and GOTV.
    Modified at 2025-09-20 09:15:15
    Next
    Providers
    Built with