Většina vývojářů už dokumentaci nečte od začátku do konce. Místo toho vloží stránku do AI asistenta pro psaní kódu a nechají ho napsat integraci. Pokud dokumentace nebyla napsána s ohledem na tento postup, asistent hádá — a hádání v platební integraci znamená špatně použitá pole s poplatky, opomenuté případy webhooků nebo checkout, který vypadá správně, dokud ho nerozbije událost refundace nebo chargebacku.
Přesně tento problém jsme řešili na docs.costplus.io. Dokumentace byla přepracována tak, aby fungovala stejně dobře pro AI asistenta, který ji čte, jako pro vývojáře, který si ji čte přímo.
1. Co se na docs.costplus.io změnilo
Základní dokumentace na docs.costplus.io/docs nyní nabízí dvě věci, které si vývojáři dříve museli skládat ručně:
- Kopii ve formátu markdown ke každé stránce, díky čemuž lze přesný zdrojový obsah vložit do AI asistenta bez HTML šumu, navigačních prvků nebo poškozeného formátování.
- Předpřipravené AI prompty navázané na relevantní stránky, formulované tak, aby přesně popisovaly integrační úkol pro Cost+ — včetně API polí, očekávaných odpovědí a struktury poplatků IC++ (Interchange Plus Plus).
- Zkratky „otevřít v AI“, které pošlou obsah stránky přímo do propojeného AI nástroje a zcela vynechají krok kopírování a vkládání.
Nejvíc to pomáhá u těch částí integrace, kde se snadno udělá nenápadná chyba: autorizační toky, zpracování webhooků a to, jak by se měly složky poplatku IC++ — interchange, scheme fee a marže Cost+ — číst a zobrazovat zpět obchodníkovi. Prompt, který tyto specifika už obsahuje, snižuje riziko, že si asistent domyslí nesprávný předpoklad.
2. Samostatný AI hub
Společně s aktualizací dokumentace zveřejnil Cost+ i samostatný hub na docs.costplus.io/ai. Je postavený speciálně pro týmy, které používají AI nástroje jako součást implementačního procesu, nikoli jako obecnou sekci s často kladenými dotazy přilepenou k dokumentaci pro vývojáře.
Hub shromažďuje vše, co vývojář potřebuje, když předává integrační úkol AI asistentovi:
- Šablony promptů zaměřené na běžné integrační cíle, jako je napojení API, nastavení Hosted Payment Page nebo zpracování webhooků pro refundace a chargebacky.
- Přímé odkazy do API reference formátované jak pro strojové, tak pro lidské čtení.
- Doporučení, které části integrace by měl ještě zkontrolovat člověk — konkrétně logika zobrazování cen a procesy citlivé z hlediska compliance.
Tento poslední bod je záměrný. Cost+ nenaznačuje, že by AI nástroje měly bez dohledu rozhodovat o všem v platební integraci. Logika poplatků, zpracování chargebacků a cokoliv, co se zákazníkovi zobrazuje v souvislosti s cenou, by mělo před nasazením do produkce ještě projít lidskou kontrolou.
3. Proč na tom u plateb konkrétně záleží
Platební integrace nesou vyšší riziko než běžná integrace API. Chybně napsaný handler webhooku pro událost chargebacku, nebo checkout stránka zobrazující nesprávný rozpis poplatků, mají reálné finanční důsledky — nejen rozbité uživatelské rozhraní.
Dobrá dokumentace pro AI nástroje se neliší od dobré dokumentace pro vývojáře — je jen přesnější v detailech, které si asistent sám nedokáže odvodit.
Asistent čtoucí nestrukturovaný text musí hádat, které pole poplatku odpovídá které položce. Prompt, který explicitně uvádí strukturu IC++, toto hádání odstraňuje.
Právě zde cenový model Cost+ dělá úkol dokumentace o dost snazší. Protože ceny Cost+ jsou rozepsané na interchange, scheme fee a marži Cost+ místo sloučení do jedné neprůhledné sazby, existuje jasná a stabilní struktura, kterou lze zdokumentovat a zakódovat do promptu. Poskytovatel s paušální sazbou, který uvádí jedno číslo, nemůže nabídnout stejnou přesnost — není tam nic podrobného, co by šlo popsat.
4. Jak to vypadá v praxi
Řekněme, že vývojář integruje Cost+ do obchodu na WooCommerce a chce, aby mu s napojením checkoutu pomohl AI asistent. Místo toho, aby vložil obecný odkaz na „dokumentaci Cost+“ a doufal, že asistent sám uhodne správné endpointy, může nyní postupovat takto:
- Otevřít příslušnou integrační stránku na docs.costplus.io/docs.
- Použít markdown kopii nebo zkratku „otevřít v AI“ a předat asistentovi přesný, aktuální obsah — ne zastaralý souhrn z tréninkových dat modelu.
- Vybrat konkrétní prompt z docs.costplus.io/ai pro daný úkol, například zobrazení rozpisu poplatku IC++ na stránce s potvrzením objednávky.
- Před nasazením zkontrolovat vygenerovanou integraci oproti API referenci, zejména zobrazení poplatků a logiku webhooků.
Výsledkem je méně kol mezi stavem „AI vytvořila něco věrohodného“ a stavem „AI vytvořila něco správného“. Právě v tomto rozdílu se ztrácí většina času při integraci.
5. Držet krok s tím, jak se kód skutečně píše
Vývoj s pomocí AI není pro platební společnosti otázkou budoucnosti — už dnes se tak vytváří významná část integrací. Dokumentace, která počítá s tím, že si vývojář ručně přečte každý odstavec, je dokumentace, která je už pozadu. Aktualizace docs.costplus.io tak, aby fungovala stejně dobře jako referenční materiál pro lidi i jako vstup připravený pro AI, je přímou reakcí na tento posun, ne spekulativní sázkou.
Na cenách Cost+ ani na způsobu zpracování transakcí se tím nic nemění — ceny IC++, zveřejněná nabídka pro nízké riziko i stejní partneři pro acquiring zůstávají přesně tak, jak jsou zdokumentované. Změnilo se to, jak rychle a přesně lze tuto strukturu převést do funkčního kódu.
Pokud plánujete integraci, začněte na docs.costplus.io/docs nebo v AI hubu a aktuální podmínky poplatků si ověřte pomocí naší kalkulačky poplatků, případně kontaktujte obchodní tým, pokud váš případ použití vyžaduje individuální nabídku.
