This method retrieves billers based on the supplied search criteria
HTTP Method: GET
Resource Url
https://sandbox.interswitchng.com/api/v2/quickteller/billers/{billerId}/paymentitems
Headers
Please refer to attached document to learn how to compute the required headers for authentication.
ISA01000I Interswitch Services API Specification
Authentication Headers
| Content Type:application/json Authorization:InterswitchAuth SUifhfjdbxbkfhj132hdfhjshfjhsv Signature: kuTwggg/3gdgdghs= Timestamp: 1434455667788 Nonce:7333394444423754333 SignatureMethod:SHA1 TerminalID: 3DMO0001 |
Request Parameters
| Field | M/O | Length | Format | Description |
| Terminal ID | M | 8 | Alphanumeric | Terminal ID provided by Interswitch |
| BillerId | Biller id returned in GetBillers response | >2 | Numeric | Unique per biller. Returned in GetBillers response |
GetBillerPaymentItems Response
A HTTP response code 200 is sent back for a success
Response Parameters
| Field | Description | |
| ResponseCode | Response Code | |
| The following parameters are returned per biller | ||
| categoryid | Category Id | |
| billerid | Id of Quickteller Biller | |
| isAmountFixed | False is returned for variable amount, while True is returned for fixed amount | If amount is fixed, it is mandatory to send the exact returned in the GetBillerPaymentItems response in your SendBillpaymentAdvice request. |
| paymentitemid | Item Id | |
| paymentitemname | Payment Item name | |
| amount | Item Amount | |
| code | Item code | |
| currencycode | Currency code | |
| currencysymbol | ||
| itemcurrencycode | ||
| paymentcode | Unique Payment item identifier | |
Sample Response
200
{ “paymentitems”: [ { “categoryid”: “2”, “billerid”: “104”, “isAmountFixed”: false, “paymentitemid”: “14”, “paymentitemname”: “PREMIUM + FRENCH”, “amount”: “1968000”, “code”: “14”, “currencyCode”: “566”, “currencySymbol”: “NGN”, “itemCurrencySymbol”: “”, “sortOrder”: “0”, “pictureId”: “0”, “paymentCode”: “10414” }
]
}
Communication
Requests will be sent over the REST protocol