{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/en/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"AI Agent Integration (Claude, Codex, and others)","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":"ai-agent-integration-claude-codex-and-others","__idx":0},"children":["AI Agent Integration (Claude, Codex, and others)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your development team uses AI coding assistants (Claude Code, OpenAI Codex, Cursor,"," ","and others), you can speed up your SimPay integration by adding a ready-made ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agent"," ","Skill"]}," to your repository — a context file that gives your assistant accurate knowledge"," ","of our API instead of it guessing field names or the authorization scheme."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The skill isn't tied to a single tool — it works with any agent that can load a Markdown"," ","file as context."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-it-includes","__idx":1},"children":["What it includes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authorization (API key, base URL, required headers)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creating a payment (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["directChannel"]},", an example request/response, the most common"," ","mistakes that trigger antifraud rejection)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payment method values, and transaction / refund / subscription statuses"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refunds"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["IPN notifications: payload structure, signature verification (SHA-256, with a PHP"," ","example), retry behavior, dynamic IP validation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Brief pointers to BLIK Level 0 / One-Click / Recurrent Payments, DirectBilling (DCB),"," ","deferred payments (PayPo, Twisto, BLIK Pay Later), and SMS Premium"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["List of official SDKs"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A pre-launch checklist"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"installation","__idx":2},"children":["Installation"]},{"$$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 / other agents following the same convention\ngit clone https://github.com/SimPaypl/simpay-ai-skill <your-skills-dir>/simpay-api-integration\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Or via the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://skills.sh"},"children":["skills.sh"]}," CLI:"]},{"$$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":["Repository: ",{"$$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":["The skill is maintained by hand against this documentation. If you notice something is"," ","out of date, open an issue or PR in the repository."]}]},"headings":[{"value":"AI Agent Integration (Claude, Codex, and others)","id":"ai-agent-integration-claude-codex-and-others","depth":1},{"value":"What it includes","id":"what-it-includes","depth":2},{"value":"Installation","id":"installation","depth":2}],"frontmatter":{"seo":{"title":"AI Agent Integration (Claude, Codex, and others)"}},"lastModified":"2026-08-08T20:14:01.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en/ai","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}