{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-payments/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"PayKKa Payments Skill","description":"Learn how to Integration with PayKKa APIs","siteUrl":"https://docs.paykka.com","image":"/assets/logo.df495cc5e94d9633069f202c90e3a52a9aaff809e494405ba215cb8339e0714e.db81178d.png","keywords":"paykka, docs, doc, documentation, apis, api, portal","lang":"en-US"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"paykka-payments-skill","__idx":0},"children":["PayKKa Payments Skill"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The PayKKa Payments Skill gives compatible AI coding agents focused guidance for designing, implementing, and reviewing PayKKa Payments V3 integrations."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Download the Skill"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://static-fe.cb.paykka.com/paykka-doc/paykka-payments.zip"},"children":["Download paykka-payments.zip"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SHA-256: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["e74ea5bcf9b0da1382872f6ed0d35a6530327f22d275e596c471d52e5a6c8127"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-it-helps-with","__idx":1},"children":["What it helps with"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choosing between Hosted, Drop-in, Component, Encrypted Card, and API-only checkout modes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implementing V3 request signing and response verification"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Handling 3DS, session and transaction queries, and webhook callbacks"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Separating browser and server responsibilities and protecting private keys and card data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reviewing an integration for security, reliability, and production readiness"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Skill supplements the PayKKa documentation. Your integration must still use the current API documentation and the features enabled for your merchant account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"install-in-your-agent-tool","__idx":2},"children":["Install in your Agent tool"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The package follows the Agent Skills directory format and can be used by tools that support Agent Skills, including Codex, Claude Code, Cursor, and other compatible agents."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose the skills directory for your tool and scope:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Agent tool"},"children":["Agent tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"User-level directory"},"children":["User-level directory"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Project-level directory"},"children":["Project-level directory"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Codex"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.codex/skills"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".codex/skills"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Claude Code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.claude/skills"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".claude/skills"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cursor"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.cursor/skills"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cursor/skills"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Agent Skills compatible tools"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.agents/skills"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".agents/skills"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["User-level installation makes the Skill available across projects. Project-level installation keeps it scoped to one project and can be committed for your team when appropriate."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"macos-or-linux","__idx":3},"children":["macOS or Linux"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SKILLS_DIR"]}," to the directory used by your Agent tool. This example uses the shared Agent Skills directory:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"SKILLS_DIR=\"$HOME/.agents/skills\"\nmkdir -p \"$SKILLS_DIR\"\ncurl -fL https://static-fe.cb.paykka.com/paykka-doc/paykka-payments.zip \\\n  -o /tmp/paykka-payments.zip\nunzip -o /tmp/paykka-payments.zip -d \"$SKILLS_DIR\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"windows-powershell","__idx":4},"children":["Windows PowerShell"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$skillsDir"]}," to the directory used by your Agent tool. This example uses the shared Agent Skills directory:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"powershell","header":{"controls":{"copy":{}}},"source":"$skillsDir = Join-Path $HOME \".agents\\skills\"\n$archive = Join-Path $env:TEMP \"paykka-payments.zip\"\nNew-Item -ItemType Directory -Force -Path $skillsDir | Out-Null\nInvoke-WebRequest `\n  -Uri \"https://static-fe.cb.paykka.com/paykka-doc/paykka-payments.zip\" `\n  -OutFile $archive\nExpand-Archive -Path $archive -DestinationPath $skillsDir -Force\n","lang":"powershell"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Restart or reload your Agent tool after installation. The installed file should be located at:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"<skills-directory>/paykka-payments/SKILL.md\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-the-skill","__idx":5},"children":["Use the Skill"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Compatible Agent tools can select the Skill automatically based on your request. To invoke it explicitly, mention ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paykka-payments"]}," by name and describe the integration you need. Include your preferred checkout experience, payment methods, target environment and region, and frontend/backend stack when known."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example prompts:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Use the paykka-payments skill to recommend the lowest-risk checkout mode for my React and Java application.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Use the paykka-payments skill to review this PayKKa Payments V3 webhook handler for signature verification, replay protection, and idempotency.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Use the paykka-payments skill to implement Hosted Checkout in the Sandbox environment. The backend uses Spring Boot and the frontend uses React.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Security"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Review AI-generated integration code before deployment. Never put merchant private keys in browser code, and do not use plaintext card APIs unless PayKKa has confirmed the merchant's PCI qualification and enabled access."]}]}]},"headings":[{"value":"PayKKa Payments Skill","id":"paykka-payments-skill","depth":1},{"value":"What it helps with","id":"what-it-helps-with","depth":2},{"value":"Install in your Agent tool","id":"install-in-your-agent-tool","depth":2},{"value":"macOS or Linux","id":"macos-or-linux","depth":3},{"value":"Windows PowerShell","id":"windows-powershell","depth":3},{"value":"Use the Skill","id":"use-the-skill","depth":2}],"frontmatter":{"seo":{"title":"PayKKa Payments Skill"}},"lastModified":"2026-09-21T07:33:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/payments/docs/developer-resources/paykka-payments-skill","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}