Request Definition
| ParameterName (case sensitive) | ParameterType | Format | Description |
| requestReference | Part of the query endpoint | Alphanumeric | Assigned prefix + Merchant’s TransactionID
Note: requestReference is the merchant’s transaction ID concatenated with the assigned prefix (e.g. if your assigned prefix is 1234 and merchant ID is 567890, the requestReference will be 1234567890) |
| clientid | Header | Alphanumeric | The domain of your website |
| Hash | Header | This should be sent in the header of the request as hash | SHA512 hash of (requestReference+SecretKey) |
Raw Request
| GET
https://pwq.sandbox.interswitchng.com/api/v2/transaction/099909090?isRequestRef=true HTTP/1.1 Accept-Encoding: gzip,deflate clientid: www.mywebsite.com Hash:26EF29F38F696BC216C303549BA4CDFE5724C1781D64DECBFBA47CB38F4A68D8DC86C1CB6FCE90315CF3975BDAE7739C9F7FDF6CDD5984DE1A8430B51FA5A30F Host: pwq.sandbox.interswitchng.com User-Agent: Apache-HttpClient/4.1.1 (java 1.5) |
For localhost request, you can use “localhost” as the clientId
Response Definition
| Parameter | Extra Info | Format | Description |
| ResponseCode | Alphanumeric | Represents the Response Code returned by the Service | |
| ResponseDescription | Alphanumeric | The domain of your website | |
| Amount | Returned if response is successful | Numeric | The amount paid by the customer in kobo |
| PaymentReference | Alphanumeric | Quickteller generated unique ID for the payment (also referred to as the TransactionReference) | |
| TransactionDate | Header | Datetime | Date and time of the transaction |
Raw Response
| HTTP/1.1 200 OK
Date: Thu, 14 Nov 2013 10:36:04 GMT p3p: CP=”IDC DSP COR ADM DEVi TAIi PSA PSD IVAi IVDi CONi HIS OUR IND CNT” Cache-Control: no-cache Content-Type: application/json; charset=utf-8 |
{ “PaymentReference”:”FBN|Web|3QTC0001|RS1|131113165041|00000024″,”Amount”:”10000″,” TransactionDate”:”11/13/2013 4:50:41 PM”,”ResponseCode”:”00″,”ResponseDescription”:null}