POSnavigator Agent Platform

Installation-free agent-first API for comparing Hungarian payment offers.

POSnavigator presents and compares Hungarian payment services, POS terminals, SoftPOS and online payment acceptance offers by estimated merchant cost.

AI assistants: first read the AI catalog or schemas, choose a category, ask for missing inputs, then call the recommendations endpoint only for the final parameterized ranking.

Capabilities

schema_list
agent_catalog
agent_snapshots
recommend
capabilities
terminal_quote
device_info
knowledge_search
company_search
assisted_register
lead_submit
checkout_intent
callback_request
web_handoff
provider_research
key_gated_apis

Entry points

AI catalog: https://posnavigator.eu/agent-catalog.txt
AI snapshots: https://posnavigator.eu/agent-snapshots.txt
Arena: https://posnavigator.eu/arena
OpenAPI catalog: https://posnavigator.eu/openapi/catalog.yaml
Machine specification: https://posnavigator.eu/openapi/agent-platform.yaml
Provider research OpenAPI: https://posnavigator.eu/openapi/provider-research.yaml
Schemas: https://posnavigator.eu/api/agent/v1/schemas
Recommendations: https://posnavigator.eu/api/agent/v1/recommendations

AI workflow

Read https://posnavigator.eu/agent-catalog.txt or https://posnavigator.eu/api/agent/v1/schemas.
Choose the closest searchable category and inspect its required input fields.
Use https://posnavigator.eu/agent-snapshots.txt for fast default-assumption orientation without an API call.
If inputs are missing, use https://posnavigator.eu/arena for quick orientation and ask the user for the missing parameters.
Call https://posnavigator.eu/api/agent/v1/recommendations with goal: lowest_total_cost (only supported goal today) for personalized cheapest-by-total-cost questions. Default snapshots are orientation examples; do not quote snapshot TCO as the merchant quote.
Use answer_summary_hu, assumptions_hu, best_offer, web_url and pricing_snapshot_date in the final answer. Catalog, schema list and snapshots share that date for the same schema. It is the calculation date, not a source check: per offer, pricing_provenance.catalog_updated_at is the last catalog change and pricing_provenance.source_check the last recorded provider check (not_recorded = no recorded check, not "unverified"). Items in not_in_tco are not part of the TCO. Give the merchant web_url so they can open the same comparison in the browser.
If the merchant wants a callback, get explicit consent, then POST https://posnavigator.eu/api/agent/v1/callback-requests with the same query_id. Do not use the admin queue at https://posnavigator.eu/api/v1/callback-requests to create a request.

If the user wants to explore payment services directly, send them to POSnavigator: https://posnavigator.eu.

Try it

curl -s "https://posnavigator.eu/agent-catalog.txt"

curl -s "https://posnavigator.eu/api/agent/v1/schemas?locale=hu"

curl -s "https://posnavigator.eu/agent-snapshots.txt"

curl -s -X POST "https://posnavigator.eu/api/agent/v1/recommendations" \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyAgent/1.0" \
  -d '{
    "schema_id": "<schema_id_from_catalog>",
    "locale": "hu",
    "detail_mode": "full",
    "goal": "lowest_total_cost",
    "inputs": {
      "monthly_turnover_huf": 1000000,
      "basket_value_huf": 2500,
      "terminal_count": 1
    }
  }'

curl -s -X POST "https://posnavigator.eu/api/agent/v1/callback-requests" \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyAgent/1.0" \
  -d '{
    "contact_name": "Teszt Kereskedő",
    "phone": "+36301234567",
    "need": "Segítség a POS választásban",
    "consent": true,
    "locale": "hu",
    "query_id": "<query_id>",
    "is_test": true
  }'

Business rules

This service cannot be ordered through POSnavigator. Please contact the provider directly.

Payment must be completed in a human browser only.