VTU API
Get API keys
Schedule Payments›Setup

Bundles

GET https://api.paybeta.ng/v2/scheduled-payments/options

Services, billers, frequencies and meter types accepted by Create, plus min_lead_minutes and the timezone used for dates.

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

Responses

  • 200Success
Request
curl --request GET \
  --url 'https://api.paybeta.ng/v2/scheduled-payments/options' \
  --header 'Accept: application/json' \
  --header 'P-API-KEY: YOUR_SECRET_KEY'
Response
{
    "success": true,
    "data": {
        "services": [
            {
                "key": "airtime",
                "label": "Airtime",
                "billers": [
                    {
                        "biller": "mtn_vtu",
                        "name": "MTN Airtime",
                        "has_bundles": false
                    }
                ]
            },
            {
                "key": "data",
                "label": "Internet Data",
                "billers": [
                    {
                        "biller": "mtn_data",
                        "name": "MTN Data",
                        "has_bundles": true
                    }
                ]
            },
            {
                "key": "cabletv",
                "label": "Cable TV",
                "billers": [
                    {
                        "biller": "dstv",
                        "name": "DStv",
                        "has_bundles": true
                    }
                ]
            },
            {
                "key": "electricity",
                "label": "Electricity",
                "billers": [
                    {
                        "biller": "ikeja-electric",
                        "name": "Ikeja Electric - IKEDC",
                        "has_bundles": false
                    }
                ]
            }
        ],
        "frequencies": [
            {
                "key": "once",
                "label": "One time"
            },
            {
                "key": "daily",
                "label": "Daily"
            },
            {
                "key": "weekly",
                "label": "Weekly"
            },
            {
                "key": "monthly",
                "label": "Monthly"
            }
        ],
        "meter_types": [
            {
                "key": "prepaid",
                "label": "Prepaid Meter"
            },
            {
                "key": "postpaid",
                "label": "Postpaid Meter"
            }
        ],
        "min_lead_minutes": 10,
        "timezone": "Africa/Lagos"
    }
}