Billers

base_url: http://sandbox.etranzactng.com/SBP

Biller Category

Description: This endpoint displays all biller categories

Sample Request

GET /biller-category

curl `${base_url}/biller-category`
-H "Content-type: application/json"

Sample Response

GET /biller-category

{
  "status": true,
  "message": "Biller category retrieved successfully",
  "result": [
    {
      "id": 1,
      "categoryName": "Cable TV",
      "description": "This is cable TV service biller category"
    },
    {
      "id": 2,
      "categoryName": "Electricity",
      "description": "This is electricity biller category"
    },
    {
      "id": 3,
      "categoryName": "Govt Tax",
      "description": "This is Government tax biller category"
    },
    {
      "id": 4,
      "categoryName": "Internet Services",
      "description": "This is internet services biller category"
    },
    {
      "id": 5,
      "categoryName": "Toll Service",
      "description": "This is toll service biller category"
    }
  ]
}

Biller

Description: This endpoint displays all active billers under the specified Biller Category. The sample displays all billers under category 1 which is the Cable TV biller category.

Sample Request

GET /biller/category/1

curl `${base_url}/biller/category/1`
-H "Content-type: application/json"

Sample Response

GET /biller/category/1

{
  "status": true,
  "message": "Biller retrieved successfully",
  "result": [
    {
      "id": 1,
      "billerName": "GOTV",
      "billerCode": "gotv",
      "description": "This is gotv biller",
      "billCategory": null
    },
    {
      "id": 2,
      "billerName": "DSTV",
      "billerCode": "dstv",
      "description": "This is dstv biller",
      "billCategory": null
    },
    {
      "id": 3,
      "billerName": "Startimes",
      "billerCode": "startimes",
      "description": "This is startimes biller",
      "billCategory": null
    }
  ]
}

WAEC REGISTRATION AND RESULT CHECKER

Description: This endpoint is for WAEC registration and WAEC result checking. It does not require bill-query before payment

Sample Registration Request

POST / http://sandbox.etranzactng.com/SBP/bill-payment

curl `http://sandbox.etranzactng.com/SBP/bill-payment`
-H "Content-type: application/json"
-d
{
    "clientRef": "{{clientReference}}",
    "billId": 38,
    "customerId": "08094198876",
    "amount": 200
}
-X POST

Sample Registration Response

POST http://sandbox.etranzactng.com/SBP/bill-payment

{
    "status": true,
    "message": "Bill Payment was successful",
    "result": {
        "id": 2447,
        "clientRef": "test4404337007570",
        "paymentRef": "09FG24020419002717615H3FT",
        "customerId": "08094198876",
        "mobile": null,
        "email": null,
        "billId": 38,
        "billName": "WAEC Registration",
        "billType": "NON_INTEGRATED",
        "billerName": "WAEC Registration",
        "billerCode": "waec_registration",
        "amount": 200,
        "billQueryRef": null,
        "terminalId": "7000000001",
        "productId": null,
        "merchantCode": "73QABZ-TG5",
        "token": null,
        "otherInfo": null,
        "status": "PAID_PROCESSED",
        "error": "0",
        "errorMessage": null
    }
}

Sample Result Checker Request

POST / http://sandbox.etranzactng.com/SBP/bill-payment

curl `http://sandbox.etranzactng.com/SBP/bill-payment`
-H "Content-type: application/json"
-d
{
    "clientRef": "{{clientReference}}",
    "billId": 39,
    "customerId": "2347051825495",
    "amount": 200
}
-X POST

Sample Result Checker Response

POST http://sandbox.etranzactng.com/SBP/bill-payment

{
    "status": true,
    "message": "Bill Payment was successful",
    "result": {
        "id": 2448,
        "clientRef": "test8161448144358",
        "paymentRef": "09FG240204190116797KIUS2M",
        "customerId": "2347051825495",
        "mobile": null,
        "email": null,
        "billId": 39,
        "billName": "WAEC Result Checker",
        "billType": "NON_INTEGRATED",
        "billerName": "WAEC Result Checker",
        "billerCode": "waec_result_checker",
        "amount": 200,
        "billQueryRef": null,
        "terminalId": "7000000001",
        "productId": null,
        "merchantCode": "73QABZ-TG5",
        "token": null,
        "otherInfo": null,
        "status": "PAID_PROCESSED",
        "error": "0",
        "errorMessage": null
    }
}