1. Bulk Airtime
PAYBETA API
  • Bill Payment API
  • Webhook
  • Paybeta Commission
  • Scheduled Payments
  • 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
    • Validate Account
    • Payment
  • Wallet
    • Balance
  • Education
    • Get Providers
    • Get Exam Types
  • 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
  • Bulk Airtime
    • Send bulk airtime
      POST
    • List bulk requests
      GET
    • Get bulk request
      GET
    • Download report (CSV)
      GET
    • Cancel
      POST
    • Query one number
      POST
  1. Bulk Airtime

Cancel

POST
https://api.paybeta.ng/v2/bulk-airtime/{{batchId}}/cancel
Stop recipients that have not started yet (they become cancelled, not charged). Numbers already processed are not affected.

Request

Authorization
Add parameter in header
P-API-KEY
Example:
P-API-KEY: ********************
Header Params

Responses

🟢200
application/json
Bodyapplication/json

🟠422
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff --request POST 'https://api.paybeta.ng/v2/bulk-airtime/{{batchId}}/cancel' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'P-API-KEY: <api-key>' \
--header 'Content-Type: application/json'
Response Response Example
200 - Cancelled
{
  "status": "successful",
  "message": "Bulk request cancelled. 2 recipient(s) that had not started were skipped.",
  "data": {
    "reference": "PAYROLL-OCT",
    "batch_id": "BLK-K3P9XQ2M7Z1A",
    "description": "October staff airtime",
    "status": "cancelled",
    "total_recipients": 3,
    "total_amount": 1700.0,
    "total_charge": 1644.0,
    "amount_charged": 970.0,
    "summary": {
      "successful": 1,
      "pending": 0,
      "failed": 0,
      "queued": 0,
      "cancelled": 2
    },
    "created_at": "2026-10-05T09:00:00+01:00",
    "started_at": null,
    "completed_at": null,
    "cancelled_at": "2026-10-05T09:00:06+01:00",
    "recipients": [
      {
        "row": 1,
        "reference": "STAFF-OCT-ADA",
        "biller": "mtn",
        "phone_number": "08031234567",
        "amount": 1000.0,
        "charged_amount": 970.0,
        "status": "delivered",
        "response_description": "TRANSACTION SUCCESSFUL",
        "transaction_id": "API-17619840121234567",
        "processed_at": "2026-10-05T09:00:12+01:00"
      },
      {
        "row": 2,
        "reference": "PAYROLL-OCT-2",
        "biller": "glo",
        "phone_number": "08051234567",
        "amount": 500.0,
        "charged_amount": null,
        "status": "cancelled",
        "response_description": "Cancelled by merchant before processing.",
        "transaction_id": null,
        "processed_at": null
      },
      {
        "row": 3,
        "reference": "PAYROLL-OCT-3",
        "biller": "airtel",
        "phone_number": "08021234567",
        "amount": 200.0,
        "charged_amount": null,
        "status": "cancelled",
        "response_description": "Cancelled by merchant before processing.",
        "transaction_id": null,
        "processed_at": null
      }
    ]
  }
}
Modified at 2026-10-06 21:07:27
Previous
Download report (CSV)
Next
Query one number
Built with