This method is used to perform Quickteller Bill Payment Inquiry
HTTP Method: POST
Resource Url
https://sandbox.interswitchng.com/api/v2/quickteller/transactions/inquirys
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
Fields | M/O | Length | Format | Description |
paymentCode | M | <=20 | Alphanumeric | The Payment Code that identifies the biller. Please see Get Biller response |
customerId | M | <=50 | Alphanumeric | Customer ID e.g. smart card number, meter number |
customerMobile | O | <=50 | Alphanumeric | Customer mobile number |
customerEmail | O | <=50 | Alphanumeric | Customer email |
Funds Transfer Request
Sample Request
1 2 3 4 5 6 |
{ "paymentCode": "04226901", "customerId": "3394433", "customerMobile": "08032269223", "customerEmail": "customer1@gmail.com" } |
A HTTP response code 200 is sent back for a success
Response Parameters
Field | Description | |
ResponseCode | Response Code | |
customerName | Customer’s name | |
TransactionReference | Unique Transaction reference generated by Interswitch | |
shortTransactionRef | Transaction reference | |
narration | Transaction remark. This will show up in Customer’s bank statement | |
surcharge | The transaction fee to be charged by Interswitch |
HTTP 200Sample Response
1 2 3 4 5 6 7 8 |
{ "customerName": "Customer1", "responseCode": 90000, "shortTransactionRef": 999917432654, "narration": "QTBPMBJA0/2954928/1629841178 LANG", "transactionRef": "AQT|T|MOB|4AQT0001|BJA|241016154118|00012478", "surcharge": 10000 } |
Communication
Requests will be sent over the REST protocol