Pro AI agenty

Integrace na jeden prompt

Používáte Claude Code, Cursor nebo jiného AI agenta? Připravili jsme skill — kompletní integrační návod ve formátu, kterému AI rozumí. Nainstalujete ho do projektu a agent napojí platby za vás: správné endpointy, klíče, widget i ověřování webhooků.

1. Stáhněte skill do projektu

Jeden markdown soubor, žádné závislosti. Pro Claude Code ho stačí vložit do .claude/skills/ v kořeni projektu:

instalace-skillu.sh

mkdir -p .claude/skills/bezbrany-payments
curl -fsSL https://bezbrany.cz/skills/bezbrany-payments/SKILL.md \
  -o .claude/skills/bezbrany-payments/SKILL.md

Stáhnout SKILL.md Zobrazit obsah

Používáte jiného agenta? Soubor funguje i jako obyčejný kontext — vložte jeho obsah do promptu, nebo na něj agenta odkažte. Strojově čitelný souhrn je také na bezbrany.cz/llms.txt.

Co skill obsahuje

Adresy API a dashboardu, OpenAPI specifikace

API klíče (sk_live_, sk_test_, pk_) a kam který patří

REST API s příklady requestů a odpovědí

Widget — embed i programatická inicializace

Webhooky včetně ověření HMAC podpisu

Implementační checklist a časté chyby

2. Zadejte agentovi úkol

Agent si skill načte sám, jakmile úkol zmíní BezBrany. Příklad promptu:

prompt.txt

Napoj náš e-shop na BezBrany platby podle skillu bezbrany-payments.
Chci: vytvoření platby při dokončení objednávky, platební widget
na stránce objednávky a webhook, který objednávku označí jako
zaplacenou. Testovací API klíč je v env proměnné BEZBRANY_API_KEY.

Předtím si v dashboardu vygenerujte testovací API klíč (sk_test_…) — agent s ním otestuje celý flow včetně simulace zaplacení, bez skutečných peněz.

Adresy v produkci

API base URL	https://api.bezbrany.cz
OpenAPI specifikace	https://api.bezbrany.cz/api/v1/docs/openapi.json
Platební widget	https://api.bezbrany.cz/widget/v1.js
Hosted checkout	https://bezbrany.cz/platba/{paymentCode}

Podrobnosti pro lidi najdete v dokumentaci; kompletní referenci ve Swaggeru.