{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Integracja przez agenta AI (Claude, Codex i inne)","description":"Znajdziesz tutaj wszystkie niezbędne informacje dotyczące integracji i obsługi systemu płatności SimPay.pl","siteUrl":"https://docs.simpay.pl","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integracja-przez-agenta-ai-claude-codex-i-inne","__idx":0},"children":["Integracja przez agenta AI (Claude, Codex i inne)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jeśli Twój zespół programistyczny korzysta z asystentów kodujących opartych o AI"," ","(Claude Code, OpenAI Codex, Cursor i inne), możesz przyspieszyć integrację z SimPay,"," ","dodając do swojego repozytorium gotowy ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agent Skill"]}," — plik z kontekstem, który daje"," ","asystentowi dokładną wiedzę o naszym API zamiast zgadywania nazw pól czy sposobu"," ","autoryzacji."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Skill nie jest przypisany do jednego narzędzia — działa z każdym agentem, który potrafi"," ","wczytać plik Markdown jako kontekst."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"co-zawiera","__idx":1},"children":["Co zawiera"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Autoryzację (klucz API, adres bazowy, wymagane nagłówki)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tworzenie płatności (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["directChannel"]},", przykładowy request/response, najczęstsze błędy"," ","powodujące odrzucenie przez antyfraud)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wartości metod płatności oraz statusy transakcji, zwrotów i subskrypcji"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Zwroty"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Powiadomienia IPN: strukturę payloadu, weryfikację sygnatury (SHA-256, z przykładem"," ","w PHP), zachowanie przy ponowieniach, dynamiczną walidację adresu IP"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Skrócone informacje o BLIK Level 0 / One-Click / Płatnościach Powtarzalnych,"," ","DirectBilling (DCB), płatnościach odroczonych (PayPo, Twisto, BLIK Płacę Później)"," ","oraz SMS Premium"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Listę oficjalnych SDK"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Checklistę przed wdrożeniem produkcyjnym"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"instalacja","__idx":2},"children":["Instalacja"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Claude Code\ngit clone https://github.com/SimPaypl/simpay-ai-skill .claude/skills/simpay-api-integration\n\n# Codex / inne agenty korzystające z tej samej konwencji\ngit clone https://github.com/SimPaypl/simpay-ai-skill <katalog-skilli>/simpay-api-integration\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Albo przez CLI ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://skills.sh"},"children":["skills.sh"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npx skills add SimPaypl/simpay-ai-skill\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Repozytorium: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/SimPaypl/simpay-ai-skill"},"children":["github.com/SimPaypl/simpay-ai-skill"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Skill jest utrzymywany ręcznie na podstawie tej dokumentacji. Jeśli zauważysz, że coś"," ","jest nieaktualne, zgłoś to przez issue lub PR w repozytorium."]}]},"headings":[{"value":"Integracja przez agenta AI (Claude, Codex i inne)","id":"integracja-przez-agenta-ai-claude-codex-i-inne","depth":1},{"value":"Co zawiera","id":"co-zawiera","depth":2},{"value":"Instalacja","id":"instalacja","depth":2}],"frontmatter":{"seo":{"title":"Integracja przez agenta AI (Claude, Codex i inne)"}},"lastModified":"2026-08-08T20:14:01.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ai","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}