This method is used to notify the biller of the payment
HTTP Method: POST
Resource Url
https://sandbox.interswitchng.com/api/v2/quickteller/sendAdviceRequest
Headers
Click here to learn how to compute the required headers for authentication.
Authentication Headers
| Content Type:application/json Authorization:InterswitchAuth SUifhfjdbxbkfhj132hdfhjshfjhsv Signature: kuTwggg/3gdgdghs= Timestamp: 1434455667788 Nonce:7333394444423754333 SignatureMethod:SHA1 |
Request Parameters
| Field | M/O | Length | Description |
| TerminalId | M | Terminal ID assigned by Interswitch | |
| PaymentCode | M | <=20 | Unique payment code retrieved from GetBillerPaymentItems call |
| CustomerId | M | <=50 | Customer’s Unique Identifier |
| CustomerMobile | O | <=13 | Customer’s Mobile Number |
| CustomerEmail | O | <=50 | Customer’s Email Address |
| Amount | M | Amount Paid by customer. Amount should be sent in lower denomination | |
| requestReference | M | <=12 | Unique requestReference generated on Client’s system and sent in DoTransfer request. 4 digit requestreference prefix will be provided by Interswitch. |
| CustReference | M | 10 | MTCN |
| PayerCountryCode | M | ||
| PayeeAccountNumber | M | ||
| PayeeAccountType | M | ||
| Amount | M | ||
| ExpectedCurrency | M | ||
| PayeeFirstname | M | ||
| PayeeSurname | M | ||
| ReceiverPhoneNumber | M | ||
| TestAnswer | M | ||
| IdType | O | ||
| IdNumber | O | ||
| CountryOfIssue | O | ||
| DateOfBirth | O | ||
| IdExpirationDate | O | ||
| CountryOfBirth | O | ||
Bill Payment Request
|
1 2 3 4 5 6 7 8 9 |
{ "paymentCode":"50204", "customerId":"0693621805", "customerMobile":"2348056731576", "customerEmail":"iswtester2@yahoo.com", "pageFlowValues":"CustReference:5381319048|PayerCountryCode:AE|PayeeAccountNumber:0115715470|PayeeAccountType:20|Amount:100000|ExpectedCurrency:566|PayeeFirstname:Peace|PayeeSurname:Idaewor|ReceiverPhoneNumber:08056731576|TestAnswer:ans|IdType:Driver's License|IdNumber:123456|CountryOfIssue:NG|DateOfBirth:20082017|IdExpirationDate:12122020|CountryOfBirth:NG|", "requestReference":"1453100010125", "amount":100000 } |
Bill Payment Response
A HTTP response code 200 is sent back for a success
Response Parameters
| Field | Description |
| transactionRef | Unique Transaction reference generated by Interswitch |
| transferCode | |
| recipientName | This should be displayed on the receipt |
Sample Response
HTTP Response Code: 200
|
1 2 3 4 5 |
{ "transactionRef":"WU|GTB|AC|310717153744|CUGFQVHQUU", "transferCode":"102900048490", "recipientName": "TEST1 TEST2 TEST3" } |
Communication
Requests will be sent over the REST protocol