用途：调用 Interswitch Transaction Search API 检索交易详情，服务于对账、报表与争议处理。
主要能力与端点：
- 快速搜索 GET /api/v1/transactions/search/quick，按 transactionRef 单笔查询；
- 参考号搜索 GET /api/v1/transactions/search/reference，按 reference 与 referenceType（MERCHANT 或 PAYMENT）查询，返回交易列表；
- 高级/批量搜索 POST /api/v1/transactions/search，支持 startDate、endDate、status（SUCCESS/FAILED/PENDING/ALL）、channel（WEB/POS/ATM/MOBILE/ALL）、minAmount、maxAmount（以 kobo 为单位）、merchantCode、page、pageSize（最大 100），返回 transactions、totalCount、page、pageSize、totalPages。
使用方式：请求需携带鉴权头（getAuthHeaders），基础地址来自环境变量 INTERSWITCH_BASE_URL；金额以 kobo 存储，展示时除以 100。批量结果建议分页拉取，可逐页累积直至 page 等于 totalPages。
典型场景：本地记录与 Interswitch 成功交易按 transactionRef 比对，输出 matched 数量、未匹配的 ref 列表与金额不一致明细；按状态与渠道过滤缩小结果集。
限制与建议：日期范围建议不超过 30 天；避免一次性拉取全部数据，应分页并缓存结果；官方资料未提供具体配额、鉴权方式细节、错误码与收费信息，暂未提供。