Skip to content

Authentication

Server integrations authenticate with merchant API keys using X-API-Key: tyv_test_… / tyv_live_… or Authorization: Bearer tyv_… (API keys only).

The merchant dashboard uses a separate browser session. Integrations must not reuse dashboard session credentials as API authentication.

  • API key secrets are shown once on create/rotate; store them only on your server.
  • User session tokens are not accepted as Bearer credentials for merchant APIs.
  • Routes under /v1/merchants/{merchantID} enforce merchant isolation.

Sourced from backend developer guide and OpenAPI. If a field is missing from the published contract, it is intentionally omitted here.