PAYBETA API
    • Bill Payment API
    • Webhook
    • 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
    • Education
      • Get Providers
        GET
      • Get Exam Types
        POST
    • Transaction Query
      POST

    Bill Payment API

    paybeta-banner.png

    Overview#

    The Paybeta API is a robust, RESTful web service designed to help developers seamlessly embed online bills payment capabilities natively into their applications.
    By integrating our API, you gain instant access to major utility services across Nigeria, including 9 out of 11 Electricity Distribution Companies (DisCos), major telecommunications networks (MTN, Airtel, Glo, 9Mobile), and popular cable TV providers (DSTV, GOTV, StarTimes). Paybeta abstracts all background complexities and direct service provider relationships so you can focus on building your product.

    Core Architecture#

    Protocol: REST
    Data Format: JSON (Structured Requests & Responses)
    Commission: View our full Commission Rate Schedule

    Supported Services#

    You can offer four primary utility payment categories via the Paybeta API:
    Airtime & Data: Instant top-ups across all major telcos (MTN, Airtel, GLO, and 9Mobile).
    Electricity: Support for active DisCos including EKEDC, JED, KEDCO, AEDC, KAEDCO, EEDC, IKEDC, IBEDC, and PHED. (Note: Yola Disco and Benin Disco are currently unsupported).
    Cable TV: Seamless subscription renewals for DSTV, GOTV, and StarTimes.
    Government & Levies: Digital payment processing for structured taxes and levies.

    Onboarding & API Access#

    1.
    Account Registration
    Create your developer account on the appropriate environment:
    Sandbox Environment: Register for a Sandbox Account to test integrations safely.
    Production Environment: Register for a Production Account when you are ready to go live.
    2.
    Request Access & Verification
    Reach out to our support team at support@paybeta.ng to request API activation.
    Join our developer ecosystem via the Paybeta Slack Community for real-time technical support.
    Your assigned Account Manager will guide you through the compliance checklist to submit required KY (Know Your Customer) and KYB (Know Your Business) documentations.

    General API Information#

    ⚠️ Important: Your account must be explicitly approved and enabled for Live Mode by the Paybeta compliance team before you can successfully make calls to our production endpoints.

    Base URLs:#

    EnvironmentBase URL
    Sandbox (Testing)https://api.sandbox.paybeta.ng
    Production (Live)https://api.paybeta.ng

    Authentication & Headers#

    All API requests must be made over secure HTTPS. Authentication is handled via API Keys passed inside the custom request headers. You can retrieve your unique API keys directly from the Paybeta Console Settings.

    Required Request Headers#

    Header KeyExpected ValueDescription
    Acceptapplication/jsonExplicitly enforces the response format.
    Content-Typeapplication/jsonEnforces the request payload format.
    P-API-KEYYour-Secret-API-KeyCustom header used to authorize your API requests.
    Header Authentication Example

    Response Schema#

    Every response returned by the Paybeta API adheres to a standardized JSON schema, allowing for predictable error handling and data parsing.
    FieldTypeDescription
    statusstringReflects the state of the transaction. Expected values: successful, failed, or pending.
    messagestringHuman-readable details or context concerning the API request status.
    dataobjectPayload containing relevant transactional metadata. For example, it returns token/units for Electricity, or generated pins for ePIN requests.

    What services can you offer?#

    flow.png
    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 2026-06-03 05:17:49
    Next
    Webhook
    Built with