# Setl > Česká platební platforma pro QR platby bankovním převodem (SPAYD) bez karetní brány. > Zákazník naskenuje QR kód v bankovní aplikaci, převod jde přímo na účet obchodníka > a Setl ho automaticky spáruje. API base URL: https://api.bezbrany.cz Klíčová fakta pro integraci: - REST API: https://api.bezbrany.cz (OpenAPI: https://api.bezbrany.cz/api/v1/docs/openapi.json) - Částky jsou v korunách jako decimal (100 = 100,00 Kč), měna CZK - Autentizace: hlavička `X-API-Key` (klíče `sk_live_…` / `sk_test_…`, jen server), hlavička `X-Public-Key` (klíč `pk_…`, frontend, jen vytvoření platby přes widget API) - První krok integrace: GET https://api.bezbrany.cz/api/v1/settings (X-API-Key) — ověří klíč, vrátí webhook secret, povolené domény, tarif a zda je účet připravený přijímat platby - Nastavení bez klikání: PUT /api/v1/settings/webhook {"url": …}, POST /api/v1/settings/cors-origins {"origin": …} - Klíče vytváří jen přihlášený majitel: https://setl.cz/nastenka/nastaveni/pripojit (vytvoří sk_test_ + pk_ a vypíše pokyny ke zkopírování); pokud klíče nemáš, pošli uživatele tam - Vytvoření platby: POST https://api.bezbrany.cz/api/v1/payments — povinné jen amount, currency, orderNumber; `qrCodeData` v odpovědi je obrázek PNG jako data URI, ne textový SPAYD - Test bez peněz: sk_test_ klíč + POST /api/v1/payments/{paymentCode}/simulate-success (spustí i webhook) - Widget: - Hosted checkout: https://setl.cz/platba/{paymentCode} - Webhooky podepsané HMAC SHA-256 (hlavička X-BezBrany-Signature) - Webhooky se odesílají ve všech tarifech včetně Free (i při simulaci testovací platby) - Limit tarifu: měsíční limit spárovaných plateb z integrace, tj. přes API, widget a checkout (Free 20, Pro neomezeně) + 10 % tolerance; platby z pokladny Setl mají vlastní limit (Free 200); nad ním vrací vytvoření platby HTTP 402 s `code: "PLAN_LIMIT_REACHED"` a `details: { limit, current, max, plan, upgradeTo }` — zákazníkovi ukaž přívětivou zprávu / náhradní platební instrukce a upozorni obchodníka; už vytvořené platby se spárují vždy. Stejně 402 vrací přidání bankovního účtu nad limit (Free 1, Pro 10) - Pole `branding` (boolean) v GET /api/v1/widget/payments/{paymentCode}: `true` na Free → widget a checkout zobrazí odkaz „Platby přes Setl“ ## Dokumentace - [Celý návod v jednom souboru](https://setl.cz/llms-full.txt): totéž co skill níže, bez hlavičky - [Skill pro AI agenty — kompletní integrační návod](https://setl.cz/skills/bezbrany-payments/SKILL.md): instalovatelný skill (Claude Code, Cursor apod.) s příklady, checklistem a častými chybami - [Dokumentace pro vývojáře](https://setl.cz/dokumentace): rychlý start, REST API, widget, webhooky (jako markdown: https://setl.cz/dokumentace.md) - [Stránka pro AI integraci](https://setl.cz/ai): jak skill nainstalovat a použít ## Registrace - [Založení účtu](https://setl.cz/prihlaseni): magic link nebo Google; každý účet začíná na tarifu Free bez časového omezení - [Ceník](https://setl.cz/cenik): Free 0 Kč (do 20 plateb z e-shopu a 200 plateb v pokladně za měsíc), Pro 249 Kč/měsíc nebo 2 490 Kč/rok (neomezeně); žádná procenta z obratu - [Bezpečnost](https://setl.cz/bezpecnost): peníze jdou přímo na účet obchodníka, Setl má k bance jen čtecí přístup