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",
    "commission": 3.00
  }
}

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",
    "commission": 1.50
  }
}

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",
    "commission": 5.00
  }
}

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",
    "commission": 13.87
  }
}

Buy WAEC Result Checker PIN

Purchase PINs to check WAEC results. Use provider_code: "result-checker". The optional quantity field allows buying multiple PINs at once.

{
  "service_type": "education",
  "provider_code": "result-checker",
  "package_code": "waecdirect",
  "recipient": "08011111111",
  "quantity": 2
}

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": "education",\n  "provider_code": "result-checker",\n  "package_code": "waecdirect",\n  "recipient": "08011111111",\n  "quantity": 2\n}'

{
  "success": true,
  "message": "Purchase successful",
  "data": {
    "reference": "WS_ABC123",
    "amount": 1500.00,
    "recipient": "08011111111",
    "service_type": "education",
    "package": "WASSCE",
    "cards": [
      {
        "Serial": "WRN123456790",
        "Pin": "098765432112"
      },
      {
        "Serial": "WRN123456791",
        "Pin": "098765432113"
      }
    ],
    "commission": 300.00
  }
}

Buy WAEC Registration PIN

Purchase registration PINs for WAEC examinations. Use provider_code: "registration".

{
  "service_type": "education",
  "provider_code": "registration",
  "package_code": "waec-registraion",
  "recipient": "08011111111",
  "quantity": 1
}

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": "education",\n  "provider_code": "registration",\n  "package_code": "waec-registraion",\n  "recipient": "08011111111",\n  "quantity": 1\n}'

{
  "success": true,
  "message": "Purchase successful",
  "data": {
    "reference": "WS_ABC123",
    "amount": 14360.00,
    "recipient": "08011111111",
    "service_type": "education",
    "package": "WASSCE for Private Candidates - Second Series (2019)",
    "tokens": ["0100070365657400875"],
    "purchased_code": "Token: 0100070365657400875",
    "commission": 90.00
  }
}

💡

Test Numbers:
- Data/Airtime recipient: 08011111111
- Electricity prepaid meter: 1111111111111
- Electricity postpaid meter: 1010101010101
- DSTV decoder: 1212121212
- WAEC packages are available in the sandbox; use any valid package code from /packages.
- Commission: The commission field shows your earnings on that transaction.