# PayKKa Payments Skill

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

Download the Skill
[Download paykka-payments.zip](https://static-fe.cb.paykka.com/paykka-doc/paykka-payments.zip)

SHA-256: `e74ea5bcf9b0da1382872f6ed0d35a6530327f22d275e596c471d52e5a6c8127`

## What it helps with

- 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.

## Install in your Agent tool

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:

| Agent tool | User-level directory | Project-level directory |
|  --- | --- | --- |
| Codex | `~/.codex/skills` | `.codex/skills` |
| Claude Code | `~/.claude/skills` | `.claude/skills` |
| Cursor | `~/.cursor/skills` | `.cursor/skills` |
| Agent Skills compatible tools | `~/.agents/skills` | `.agents/skills` |


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.

### macOS or Linux

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

```bash
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"
```

### Windows PowerShell

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

```powershell
$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:

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

## Use the Skill

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:

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

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

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

Security
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.