1. Home
  2. Quickteller SVA
  3. Get Biller Payment Items

Get Biller Payment Items

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

Was this article helpful to you? Yes No

How can we help?