This method is used to notify the biller of the payment
HTTP Method: POST
Resource Url
https://sandbox.interswitchng.com/api/v2/quickteller/payments/advices
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 | 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. | |
Bill Payment Request
{
“TerminalId”:”3DMO0001″,
“paymentCode”:”10403″,
“customerId”:”0000000001″,
“customerMobile”:”2348056731576″,
“customerEmail”:”iswtester2@yahoo.com”,
“amount”:”360000″,
“requestReference”:”1194000023″
}
Bill Payment Response
A HTTP response code 200 is sent back for a success
Response Parameters
| Field | Description | |
| TransactionReference (A billPayment transaction) | Unique Transaction reference generated by Interswitch | |
| MiscData (Only returned if a billpayment is PIN based) | Biller’s Token | |
| PIN(Only returned if a billpayment is PIN based) | Biller’s Token | |
| ResponseCodeGrouping | A response of status is returned (SUCCESS, FAILED, or PENDING) | |
Sample Response
200
Communication
Requests will be sent over the REST protocol
NOTE: Kindly ensure the QueryTransaction request is made no earlier than 360secs after Send BillPayment Advice response has been received or the timeout period has elapsed. Also, ensure your request timeout is set to a minimum of 60secs for Send BillPayment Advice.