PAYBETA API
    • Bill Payment API
    • Webhook
    • Paybeta Commission
    • 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
    • Webhook (reference)
    • Schedule Payments
      • Setup
        • Options
        • Bundles
      • Create
        • Create - Airtime (one time)
        • Create - Data (monthly)
        • Create - Cable TV (monthly)
        • Create - Electricity (weekly)
      • Manage
        • List schedules
        • Get schedule
        • Update schedule
        • Pay now
        • Retry failed run
        • Pause
        • Resume
        • Cancel (archive)
        • Re-enable
        • Delete
    • Transaction Query
      POST

    Webhook (reference)

    Each run that debits your wallet is reported to your registered webhook endpoint, in the same format as a direct purchase. data.reference is the run's transaction reference (it starts with the schedule reference), and transactionId matches the schedule's last_run.transaction_id.
    {
      "eventType": "transaction.successful",
      "type": "data",
      "data": {
        "reference": "SCH-7F3K9QX2AB12-K3P9XQ2M",
        "amount": "1,000.00",
        "chargedAmount": "970.00",
        "commission": "30.00",
        "biller": "MTN 1GB - 30 Days",
        "customerId": "08031234567",
        "token": "0",
        "unit": "0",
        "voucher": "0",
        "currency": "NGN",
        "transactionId": "API-17596704001234567",
        "transactionDate": "2026-11-01 09:00:12",
        "status": "SUCCESSFUL",
        "message": "Your transaction was successful"
      }
    }
    Modified at 2026-10-05 19:53:45
    Previous
    Get Exam Types
    Next
    Options
    Built with