PayKKa Payments Skill

The PayKKa Payments Skill gives compatible AI coding agents focused guidance for designing, implementing, and reviewing PayKKa Payments V3 integrations.

• Choosing between Hosted, Drop-in, Component, Encrypted Card, and API-only checkout modes
• Implementing V3 request signing and response verification
• Handling 3DS, session and transaction queries, and webhook callbacks
• Separating browser and server responsibilities and protecting private keys and card data
• Reviewing an integration for security, reliability, and production readiness

The Skill supplements the PayKKa documentation. Your integration must still use the current API documentation and the features enabled for your merchant account.

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.

Choose the skills directory for your tool and scope:

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.

Set SKILLS_DIR to the directory used by your Agent tool. This example uses the shared Agent Skills directory:

SKILLS_DIR="$HOME/.agents/skills"
mkdir -p "$SKILLS_DIR"
curl -fL https://static-fe.cb.paykka.com/paykka-doc/paykka-payments.zip \
  -o /tmp/paykka-payments.zip
unzip -o /tmp/paykka-payments.zip -d "$SKILLS_DIR"

Set $skillsDir to the directory used by your Agent tool. This example uses the shared Agent Skills directory:

$skillsDir = Join-Path $HOME ".agents\skills"
$archive = Join-Path $env:TEMP "paykka-payments.zip"
New-Item -ItemType Directory -Force -Path $skillsDir | Out-Null
Invoke-WebRequest `
  -Uri "https://static-fe.cb.paykka.com/paykka-doc/paykka-payments.zip" `
  -OutFile $archive
Expand-Archive -Path $archive -DestinationPath $skillsDir -Force

Restart or reload your Agent tool after installation. The installed file should be located at:

<skills-directory>/paykka-payments/SKILL.md

Compatible Agent tools can select the Skill automatically based on your request. To invoke it explicitly, mention 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.

Example prompts:

Use the paykka-payments skill to recommend the lowest-risk checkout mode for my React and Java application.

Use the paykka-payments skill to review this PayKKa Payments V3 webhook handler for signature verification, replay protection, and idempotency.

Use the paykka-payments skill to implement Hosted Checkout in the Sandbox environment. The backend uses Spring Boot and the frontend uses React.