Purchases

All purchase requests use POST /purchase with the appropriate payload.

Buy Data

{
  "service_type": "data",
  "provider_code": "mtn",
  "package_code": "mtn-50mb-200",
  "recipient": "08011111111"
}
curl -X POST "https://app.wisesub.com.ng/api/partner/v1/purchase" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "X-Environment: test" \
  -H "Content-Type: application/json" \
  -d '{\n  "service_type": "data",\n  "provider_code": "mtn",\n  "package_code": "mtn-50mb-200",\n  "recipient": "08011111111"\n}'
{
  "success": true,
  "message": "Purchase successful",
  "data": {
    "reference": "WS_ABC123",
    "amount": 197.00,
    "recipient": "08011111111",
    "service_type": "data",
    "package": "N200 200MB - 2 days"
  }
}

Buy Airtime

{
  "service_type": "airtime",
  "provider_code": "mtn",
  "recipient": "08011111111",
  "amount": 100.00
}
curl -X POST "https://app.wisesub.com.ng/api/partner/v1/purchase" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "X-Environment: test" \
  -H "Content-Type: application/json" \
  -d '{\n  "service_type": "airtime",\n  "provider_code": "mtn",\n  "recipient": "08011111111",\n  "amount": 100.00\n}'
{
  "success": true,
  "message": "Purchase successful",
  "data": {
    "reference": "WS_ABC123",
    "amount": 98.50,
    "recipient": "08011111111",
    "service_type": "airtime",
    "package": "₦100 Airtime"
  }
}

Buy Electricity

{
  "service_type": "electricity",
  "provider_code": "ikeja",
  "meter_number": "1111111111111",
  "meter_type": "prepaid",
  "amount": 1000,
  "phone": "08012345678"
}
curl -X POST "https://app.wisesub.com.ng/api/partner/v1/purchase" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "X-Environment: test" \
  -H "Content-Type: application/json" \
  -d '{\n  "service_type": "electricity",\n  "provider_code": "ikeja",\n  "meter_number": "1111111111111",\n  "meter_type": "prepaid",\n  "amount": 1000,\n  "phone": "08012345678"\n}'
{
  "success": true,
  "message": "Purchase successful",
  "data": {
    "reference": "WS_ABC123",
    "amount": 995.00,
    "recipient": "1111111111111",
    "service_type": "electricity",
    "package": "Electricity Payment",
    "token": "26362054405982757802",
    "units": "79.9 kWh",
    "customer_name": "N/A"
  }
}

Buy Cable TV

{
  "service_type": "cabletv",
  "provider_code": "dstv",
  "package_code": "dstv-padi",
  "decoder_number": "1212121212",
  "phone": "08012345678",
  "subscription_type": "renewal"
}
curl -X POST "https://app.wisesub.com.ng/api/partner/v1/purchase" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "X-Environment: test" \
  -H "Content-Type: application/json" \
  -d '{\n  "service_type": "cabletv",\n  "provider_code": "dstv",\n  "package_code": "dstv-padi",\n  "decoder_number": "1212121212",\n  "phone": "08012345678",\n  "subscription_type": "renewal"\n}'
{
  "success": true,
  "message": "Purchase successful",
  "data": {
    "reference": "WS_ABC123",
    "amount": 1836.13,
    "recipient": "1212121212",
    "service_type": "cabletv",
    "package": "DStv Padi N1,850"
  }
}
💡
Test Numbers:
- Data/Airtime recipient: 08011111111
- Electricity prepaid meter: 1111111111111
- Electricity postpaid meter: 1010101010101
- DSTV decoder: 1212121212