# PayKKa 支付集成 Skill

PayKKa Payments Skill 为兼容 Agent Skills 的 AI 编程助手提供针对性指导，帮助开发者设计、实现和检查 PayKKa Payments V3 集成。

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

SHA-256：`e74ea5bcf9b0da1382872f6ed0d35a6530327f22d275e596c471d52e5a6c8127`

## 可以帮你完成什么

- 在托管收银台、Drop-in、Component、加密卡和 API-only 模式之间选择合适的接入方案
- 实现 V3 请求签名和响应验签
- 处理 3DS、会话与交易查询以及 Webhook 回调
- 划分浏览器端与服务端职责，保护商户私钥和银行卡数据
- 从安全性、可靠性和生产就绪角度检查现有接入代码


Skill 用于辅助理解和使用 PayKKa 文档。实际接入仍应以最新 API 文档以及商户账号已开通的能力为准。

## 安装到你的 Agent 工具

该压缩包采用 Agent Skills 目录格式，可用于支持 Agent Skills 的工具，包括 Codex、Claude Code、Cursor 及其他兼容工具。

请根据使用的工具和安装范围选择目录：

| Agent 工具 | 用户级目录 | 项目级目录 |
|  --- | --- | --- |
| Codex | `~/.codex/skills` | `.codex/skills` |
| Claude Code | `~/.claude/skills` | `.claude/skills` |
| Cursor | `~/.cursor/skills` | `.cursor/skills` |
| 兼容 Agent Skills 的工具 | `~/.agents/skills` | `.agents/skills` |


用户级安装可在多个项目中使用该 Skill；项目级安装只对当前项目生效，适合在需要时提交到项目仓库供团队共享。

### macOS 或 Linux

请将 `SKILLS_DIR` 设置为你的 Agent 工具使用的目录。以下示例使用通用 Agent Skills 目录：

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

请将 `$skillsDir` 设置为你的 Agent 工具使用的目录。以下示例使用通用 Agent Skills 目录：

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

安装后重启或重新加载你的 Agent 工具，并确认文件位于：

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

## 使用 Skill

兼容的 Agent 工具可以根据你的需求自动选择该 Skill。如需明确调用，请在提示词中写出 `paykka-payments`，然后描述接入需求。建议同时提供期望的收银台形式、支付方式、目标环境和地区，以及前后端技术栈。

示例提示词：

```text
使用 paykka-payments skill，为我的 React 和 Java 应用推荐风险最低的收银台接入模式。
```

```text
使用 paykka-payments skill，检查这段 PayKKa Payments V3 Webhook 代码的验签、防重放和幂等处理。
```

```text
使用 paykka-payments skill，在 Sandbox 环境实现托管收银台。后端使用 Spring Boot，前端使用 React。
```

安全提示
部署前请检查 AI 生成的接入代码。请勿在浏览器代码中放置商户私钥；除非 PayKKa 已确认商户的 PCI 资质并开通权限，否则不要使用明文银行卡 API。