Interswitch Transaction Search API — Transactions

naftiko: 1.0.0-alpha2
info:
  label: Interswitch Transaction Search API — Transactions
  description: Back-office transaction search and detail lookup across Interswitch payment surfaces.
  tags:
  - Interswitch
  - Transactions
  - Reconciliation
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    INTERSWITCH_BEARER_TOKEN: INTERSWITCH_BEARER_TOKEN
capability:
  consumes:
  - type: http
    namespace: transaction-search-transactions
    baseUri: https://qa.interswitchng.com
    resources:
    - name: search-quick
      path: /transaction-search/api/v1/search/quick
      operations:
      - name: quickTransactionSearch
        method: GET
        description: Quick transaction search by date and status.
        outputRawFormat: json
        outputParameters: [{ name: result, type: object, value: $. }]
        inputParameters:
        - { name: from, in: query, type: string, required: false }
        - { name: to, in: query, type: string, required: false }
        - { name: status, in: query, type: string, required: false }
        - { name: limit, in: query, type: integer, required: false }
        - { name: cursor, in: query, type: string, required: false }
    - name: search-reference
      path: /transaction-search/api/v1/search/reference
      operations:
      - name: searchTransactionByReference
        method: GET
        description: Search by merchant or system reference.
        outputRawFormat: json
        outputParameters: [{ name: result, type: object, value: $. }]
        inputParameters:
        - { name: reference, in: query, type: string, required: true }
    - name: search-bulk
      path: /transaction-search/api/v1/search/bulk
      operations:
      - name: bulkTransactionSearch
        method: POST
        description: Bulk lookup by reference list.
        outputRawFormat: json
        outputParameters: [{ name: result, type: object, value: $. }]
        inputParameters:
        - { name: body, in: body, type: object, required: true }
    - name: transaction-detail
      path: /transaction-search/api/v1/transactions/{transactionId}
      operations:
      - name: getTransactionDetail
        method: GET
        description: Get full transaction detail.
        outputRawFormat: json
        outputParameters: [{ name: result, type: object, value: $. }]
        inputParameters:
        - { name: transactionId, in: path, type: string, required: true }
    authentication:
      type: apikey
      key: Authorization
      value: 'Bearer {{env.INTERSWITCH_BEARER_TOKEN}}'
      placement: header
  exposes:
  - type: mcp
    namespace: transaction-search-transactions-mcp
    port: 9090
    transport: http
    tools:
    - name: interswitch-quick-transaction-search
      description: Quick search.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: transaction-search-transactions.quickTransactionSearch
      with:
        from: tools.from
        to: tools.to
        status: tools.status
        limit: tools.limit
        cursor: tools.cursor
      outputParameters: [{ type: object, mapping: $. }]
    - name: interswitch-search-transaction-by-reference
      description: Reference search.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: transaction-search-transactions.searchTransactionByReference
      with: { reference: tools.reference }
      outputParameters: [{ type: object, mapping: $. }]
    - name: interswitch-bulk-transaction-search
      description: Bulk reference lookup.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: transaction-search-transactions.bulkTransactionSearch
      with: { body: tools.body }
      outputParameters: [{ type: object, mapping: $. }]
    - name: interswitch-get-transaction-detail
      description: Get full transaction detail.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: transaction-search-transactions.getTransactionDetail
      with: { transactionId: tools.transactionId }
      outputParameters: [{ type: object, mapping: $. }]