Search

Local Network mode provides two transaction search endpoints — one that queries Kushki's acquirer backend (requires internet) and one that queries the terminal's own storage (works offline). Use the offline endpoint as a fallback for same-day recovery when internet access is unavailable.

Beta — Early Access

Kushki ONE Local Network is currently in Beta for Mexico 🇲🇽. Do not deploy to production without coordinating with the Kushki integration team.

Base URL

http://{terminalIp}:6868

Authentication

Available endpoints

Endpoint	Source	Works offline
`POST /terminal/v1/sync/transaction_search_online`	Kushki acquirer backend	❌
`POST /terminal/v1/sync/transaction_search_local`	Terminal storage	✅

Online search

Queries the full transaction history from Kushki's acquirer backend. Returns all statuses and complete transaction detail.

Request

{
  "page": 1,
  "size": 10,
  "filters": {
    "last_four_digits": "5480",
    "start_date": 0,
    "end_date": 0,
    "transaction_reference": "",
    "transaction_type": ""
  }
}

INFO

Online search requires internet connectivity. If the terminal is offline, use the local search endpoint instead.

Local search

Queries transactions stored on the terminal itself. Available even when the terminal has no internet access.

Request

{
  "page": 1,
  "size": 10,
  "filters": {
    "last_four_digits": "5480",
    "start_date": 0,
    "end_date": 0,
    "transaction_reference": "",
    "transaction_type": ""
  }
}

WARNING

Local search is limited to the terminal's own storage window. For full transaction history and reconciliation, always use the online endpoint.

Request fields

Field	Type	Description
`page`	integer	Page number — starts at `1`
`size`	integer	Results per page
`filters.last_four_digits`	string	Filter by last 4 digits of the card
`filters.start_date`	integer	Start of date range (Unix ms). `0` = no filter
`filters.end_date`	integer	End of date range (Unix ms). `0` = no filter
`filters.transaction_reference`	string	Filter by Kushki transaction reference
`filters.transaction_type`	string	Filter by type: `charge`, `authorization`, `capture`, `void`, `refund`

Online vs Local — when to use each

	Online	Local
Source	Kushki acquirer backend	Terminal storage
Works offline	❌	✅
Full history	✅	Limited to terminal storage window
Use case	Reconciliation, reporting, end-of-day	Same-day recovery, offline fallback

Got a suggestion on this documentation? Contact us.

Base URL#

Authentication#

Available endpoints#

Online search#

Request#

Local search#

Request#

Request fields#

Online vs Local — when to use each#

Base URL

Authentication

Available endpoints

Online search

Request

Local search

Request

Request fields

Online vs Local — when to use each