This method is used to perform Quickteller Bill Payment Transaction
HTTP Method: POST
Resource Url
https://sandbox.interswitchng.com/api/v2/quickteller/transactions
Headers
Please refer here on 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 |
| amount | M | <=20 | Numeric | Transaction amount in minor denomination |
| pinData | M | 16 | Hexadecimal | Encrypted PIN Block |
| secureData | M | 512 | Hexadecimal | Other Transaction sensitve data e.g. Card, CVV, Exp Date |
| msisdn | O | <=13 | Numeric | Customer Mobile phone |
| transactionRef | M | <=60 | Alphanumeric | Transaction reference returned during Bill Payment inquiry call |
| cardBin | M | <=11 | Numeric | The first 11 number of the Card Number |
Request
Sample Request
|
1 2 3 4 5 6 7 8 |
{ "amount": 250000, "pinData": "****************", "secureData": "************************************************************************************************************************************************************************************************", "msisdn": 2348030014003, "transactionRef": "AQT|T|MOB|4AQT0001|KEDP|241016153410|00012392", "cardBin": 53701002040 } |
A HTTP response code 200 is sent back for a success
Response Parameters
| Field | Description | |
| responseCode | Response Code | |
| responseDescription | Response Description message | |
| transactionRef | Unique Transaction reference generated by Interswitch | |
| shortTransactionRef | Transaction reference |
ResponseCode
HTTP 200Sample Response
|
1 2 3 4 5 6 7 8 9 |
{ "responseCode": 90000, "shortTransactionRef": 999969541767, "responseDescription": "Your transaction has been processed successfully.", "rechargePin": "Virtual Top Up", "transactionRef": "UBA|MOB|4AQT0001|MTNV|241016154029|00008356", "transactionResponseCode": "00", "transactionResponseDesc": "Your transaction has been processed successfully." } |
Communication
Requests will be sent over the REST protocol