// Integration / Developer Hub

Postavte jednou. Oslov všechny obchodníky.

Most z cloudu až na edge s předvídatelnými REST endpointy, webhooky a sandboxem. Nasaďte integraci, aniž byste se dotkli jediného terminálu.

Získat API klíče → Číst dokumentaci →

create-merchant.sh

# Zaregistrujte obchodníka do svého portfolia
curl -X POST https://api.veslo.io/v1/merchants \
  -H "Authorization: Bearer $VESLO_KEY" \
  -d '{
    "legal_id": "SK2020123456",
    "brand":    "your-iso",
    "package":  "gastro",
    "device":   "pax-a920pro"
  }'

# → 201 Created
{
  "merchant_id": "mch_9f2a…",
  "status": "onboarding",
  "fiscalization": "ekasa_pending"
}

// Quickstart

Tři volání do ostrého provozu.

Ověř se, vytvoř obchodníka a začni přijímat události. Stejné API v sandboxu i v produkci.

KROK 01

Získat klíč

Vytvoř API klíč s omezeným rozsahem v Integration Hub — sandbox, nebo ostrý provoz.

export VESLO_KEY="sk_live_…"

KROK 02

Vytvoř obchodníka

Pošlete POST s obchodníkem a jeho IČO; Veslo vyřeší KYC i provisioning.

POST /v1/merchants

KROK 03

Poslouchej webhooky

Odebírej události životního cyklu — onboarding, zúčtování, stav zařízení.

POST /v1/webhooks

// Všechno, co potřebujete

Jeden hub pro celou integraci.

API

REST API

Verzované, předvídatelné endpointy pro obchodníky, zařízení, transakce a výplaty.

◇

Webhooky

Události v reálném čase s podepsanými payloady a automatickým opakováním.

⚿

OAuth & SSO

Tokeny s omezeným rozsahem, řízení přístupu na úrovni partnera a jednotné přihlášení.

▷

Sandbox

Plné testovací prostředí s mock zařízeními a simulací fiskalizace.

≣

Logy & audit

Každý požadavek a transakce, s vyhledáváním a exportem.

{ }

SDK

Typované klientské knihovny, ať píšete míň boilerplate.

// API reference

Čisté API postavené na zdrojích.

Namodeluj celý životní cyklus obchodníka hrstkou předvídatelných zdrojů. Kompletní reference a schémata na api.veslo.io.

Otevřít API referenci →

POST/v1/merchants

GET/v1/merchants/{id}

GET/v1/devices

POST/v1/devices/{id}/config

GET/v1/transactions

GET/v1/payouts

POST/v1/webhooks

// Webhooky

Reagujte na všechno, v reálném čase.

Podepsané události s opakovaným doručením pro každou podstatnou změnu v životním cyklu obchodníka — bez pollingu.

merchant.onboarded
transaction.settled
device.health.changed
payout.created

merchant.onboarded

{
  "type": "merchant.onboarded",
  "created": "2026-07-27T09:14:22Z",
  "data": {
    "merchant_id": "mch_9f2a…",
    "brand": "your-iso",
    "device": "pax-a920pro",
    "fiscalization": "ekasa_active"
  }
}

// SDK

Použijte svůj jazyk.

Typované klientské knihovny a zdokumentovaná OpenAPI spec, ze které si vygenerujete vlastního klienta.

Node.jsPythonPHPGoJavacURLOpenAPI spec

// Logy & audit

Plný přehled o každém požadavku.

Prohlédněte si API volání, doručení webhooků a transakční události. Kompletní auditní stopu vyexportujete pro compliance.

Zobrazit auditní log →

api.veslo.io/audit-logs

// Začni stavět

Získejte klíče do sandboxu.

Rozjeďte sandbox během pár minut a pošlete první volání — na prozkoumání nepotřebujete smlouvu.

Získat API klíče → Číst dokumentaci →