Quick Search

Quick Search Mode allows you to provide any of the following parameters to successfully search for a Transaction. These are some of the field you can use solely or in combination.

-Personal Account Number (PAN)

-Sequence Trace Audit Number (STAN),

-Terminal ID,

-Merchant ID

-Amount

-Beneficiary Account Number

-Date

POST Quick Search

👍

<<https://switch-online-gateway-service.k9.isw.la/switch-online-gateway-service/api/v1/gateway/quick-search>

Authorization

AuthorizationBearer TokenComments
TokenRefer to Authentication

Header

KeyValueComments
client_idYour Client ID generated for your Project on the Developer ConsoleLogin to get your Authentication

Query Params

Query ParamsBearer TokenComments
Page_size20
page_number1

Request Body

Search ParametersDescriptionLength
rrnRetrieval Reference Number generated by Issuer's system12
mechant_codeCode that uniquely identifies a Registered Merchant12
maskedpanCustomer Card Number that Initiated the transaction. First 6 and Last 4 Digits are in the clear. Everything esle in between is masked16-19
terminal_idCode that uniquely identifies a terminal belonging to Merchant.8
stantransaction number originating from terminal6
YYYY-MM-DDDate transaction was initiated. YYYY-MM-DD10
transaction_amountTransaction amount in Lower Denomination. e.g If you intend to search for N20, search parameter should be sent as 2000
to_accountBeneficiary Account that received funds. Useful for searching Transfer Transaction specifically.Typically, 10 Digits for NUBAN Accounts

Sample Request Payload

{  
  "rrn": "309238700960",  
  "merchant_code": "2057LA200001214",  
  "terminal_id": "20577C9O",  
  "stan": "022186",  
  "masked_pan": "519911**\*\***9719",  
  "transaction_date": "2023-09-23",  
  "transaction_amount": 2000,  
  "to_account": "1236475"  
}

Response Body

Response ParametersDescriptionComments
timestamptime of Search Operation
response message
responseCodetransaction number originating from terminal
dataObject containing some information for a transaction.The transaction_id in is then used to get details for the transaction. See how it's done here

Response Payload

{  
    "timeStamp": "2023-11-07T15:50:42.614+00:00",  
    "responseMessage": "Transactions Received Successfully",  
    "responseCode": "202",  
    "dataSize": 1,  
    "totalPages": 1,  
    "pageNumber": 1,  
    "pageSize": 20,  
    "data": [  
        {  
            "retrieval_reference_number": "696843517287",  
            "merchant_code": "2057LA200002957",  
            "masked_pan": "519911******3279",  
            "terminal_id": "20573ZLY",  
            "stan": "373758",  
            "unique_reference": "95aa59d0-77fb-11ee-a39f-f7013f7f10c0",  
            "transaction_date": "2023-10-09",  
            "transaction_amount": 210000,  
            "beneficiary_account": null,  
            "transaction_id": "958804c0-77fb-11ee-a39f-f7013f7f10c0",  
            "acquirer_code": "ZIB",  
            "issuer_code": "GTB"  
        }  
    ],  
    "errors": null  
}

👍

To get the Full Transaction Details. Use the transaction_id value in the response payload to make a Get Transaction Details call

You can Test out the API call directly here: