VTU API
Get API keys
Schedule Payments›Manage

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.

Send your secret key in the P-API-KEY header. Keep it on your server, never in an app or browser.

Responses

  • 200Success
  • 422Error
Request
curl --request POST \
  --url 'https://api.paybeta.ng/v2/scheduled-payments/scheduleReference/pay-now' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'P-API-KEY: YOUR_SECRET_KEY'
Response
{
    "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,
        "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"
    }
}