Billers Marketplace

Overview

Any registered business — associations, hospitals, cooperatives, professional bodies — can list services on the billers marketplace and collect from Slimpay's user base. Like school payments, biller payments go through a hosted checkout rather than a direct wallet debit.

List billers

GET /billers Public

bash

curl https://app.slimpay.ng/api/v1/billers

GET /billers

GET /billers/{slug} Public

bash

curl https://app.slimpay.ng/api/v1/billers/eko-cooperative-society

GET /billers/{slug}

slug * path

Pay a biller

POST /billers/{slug}/pay Requires Auth

Initiates a checkout — same pattern as school payments. Returns a checkout_reference plus the fee split, so you can show the payer exactly how much the biller receives.

bash

curl https://app.slimpay.ng/api/v1/billers/eko-cooperative-society/pay \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 7,
    "amount": 10000,
    "payer_name": "Tunde Adesola",
    "payer_email": "tunde@example.com"
  }'

POST /billers/{slug}/pay

This initiates a real checkout for a real biller. Use a real slug from the list above — defaulted amount kept low to limit test cost.

slug * path

service_id * body

amount * body

payer_name * body

payer_email * body

json

{
  "status": true,
  "data": {
    "checkout_reference": "BLR-3A9F2C11",
    "amount": 10000,
    "commission": 250,
    "biller_net": 9750
  }
}

Commission

Standard billers keep 97.5% of every collection (2.5% platform commission, capped at ₦2,000). Verified school billers get a reduced 1.5% rate. See the pricing page for the full breakdown.

← Previous

School Webhooks

Overview