1. Manage
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
    • Payment
  • 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
      • Get schedule
        GET
      • Update schedule
        PUT
      • Pay now
        POST
      • Retry failed run
        POST
      • Pause
        POST
      • Resume
        POST
      • Cancel (archive)
        POST
      • Re-enable
        POST
      • Delete
        DELETE
  • Transaction Query
    POST
  1. Manage

Delete

DELETE
https://api.paybeta.ng/v2/scheduled-payments/{{scheduleReference}}
Permanently delete a cancelled schedule and its run history. Transactions it created stay in your transaction history.

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 DELETE 'https://api.paybeta.ng/v2/scheduled-payments/{{scheduleReference}}' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'P-API-KEY: <api-key>' \
--header 'Content-Type: application/json'
Response Response Example
200 - Deleted
{
  "success": true,
  "message": "Schedule permanently deleted."
}
Modified at 2026-10-05 19:53:45
Previous
Re-enable
Next
Transaction Query
Built with