Pay now

POST

https://api.paybeta.ng/v2/scheduled-payments/{{scheduleReference}}/pay-now

Charge this schedule's payment immediately, on top of its normal plan. The schedule's dates, status and cycle are unchanged. Works on active and paused schedules (use Retry for failed). The result arrives on your webhook.

Request

Authorization

Add parameter in header

P-API-KEY

Example:

P-API-KEY: ********************

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request POST 'https://api.paybeta.ng/v2/scheduled-payments/{{scheduleReference}}/pay-now' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'P-API-KEY: <api-key>' \
--header 'Content-Type: application/json'

Response Example

200 - Started

{
  "success": true,
  "message": "Payment started. Your schedule dates are unchanged. Check the schedule shortly for the result.",
  "data": {
    "reference": "SCH-7F3K9QX2AB12",
    "service": "data",
    "service_label": "Internet Data",
    "biller": "mtn_data",
    "biller_label": "MTN Data",
    "biller_code": "mtn-1gb-30days",
    "product_name": "MTN 1GB - 30 Days",
    "customer_id": "08031234567",
    "customer_name": null,
    "amount": 1000.0,
    "frequency": "monthly",
    "frequency_label": "Monthly",
    "starts_at": "2026-11-01T09:00:00+01:00",
    "ends_at": null,
    "next_run_at": "2026-11-01T09:00:00+01:00",
    "status": "active",
    "failure_reason": null,
    "can_retry": false,
    "can_cancel": true,
    "can_pause": true,
    "can_pay_now": true,
    "can_resume": false,
    "resume_needs_start_at": false,
    "paused_at": null,
    "can_edit": true,
    "archived": false,
    "can_reactivate": false,
    "can_delete": false,
    "reactivation_needs_start_at": false,
    "cancelled_at": null,
    "total_runs": 0,
    "last_run_at": null,
    "last_run": null,
    "description": "Data for Mum",
    "summary": "Internet Data scheduled for the beneficiary 08031234567",
    "created_at": "2026-10-05T12:00:00+01:00"
  }
}

Modified at 2026-10-05 19:53:45

Update schedule

Retry failed run