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

Authorization	Bearer Token	Comments
Token		Refer to Authentication

Header

Key	Value	Comments
client_id	Your Client ID generated for your Project on the Developer Console	Login to get your Authentication

Query Params

Query Params	Bearer Token	Comments
Page_size	20
page_number	1

Request Body

Search Parameters	Description	Length
rrn	Retrieval Reference Number generated by Issuer's system	12
mechant_code	Code that uniquely identifies a Registered Merchant	12
maskedpan	Customer Card Number that Initiated the transaction. First 6 and Last 4 Digits are in the clear. Everything esle in between is masked	16-19
terminal_id	Code that uniquely identifies a terminal belonging to Merchant.	8
stan	transaction number originating from terminal	6
YYYY-MM-DD	Date transaction was initiated. YYYY-MM-DD	10
transaction_amount	Transaction amount in Lower Denomination. e.g If you intend to search for N20, search parameter should be sent as 2000
to_account	Beneficiary 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 Parameters	Description	Comments
timestamp	time of Search Operation
response message
responseCode	transaction number originating from terminal
data	Object 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: