> ## Documentation Index
> Fetch the complete documentation index at: https://developer.speedpay.hk/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 接入 Skill

> 为 Codex 和兼容 Agent Skills 的 AI 编程工具提供 SpeedPay Open API 接入能力。

SpeedPay Open API Integration Skill 可协助 AI 编程工具完成请求签名、Visa、JCB 卡、JCB 钱包和 Webhook 接入。Skill 默认使用测试环境，便于在联调完成后再准备生产配置。

<Card title="下载 SpeedPay Open API Integration Skill" icon="download" href="/assets/speedpay-open-api-integration.zip">
  下载后，将压缩包解压到 AI 编程工具的 skills 目录。
</Card>

## 安装

### Codex

将解压后的 `speedpay-open-api-integration` 目录放到 `~/.agents/skills/`，然后重启 Codex 或新建任务，使 Skill 被重新发现。

### 其他 Agent Skills 客户端

将完整目录放入客户端支持的 skills 目录，并保持 `SKILL.md`、`agents/openai.yaml` 与 `references/` 的相对路径不变。

## 使用示例

推荐显式调用 `$speedpay-open-api-integration`，以确保 AI 使用本 Skill 的接口约束和安全边界。

### 查询 Visa 卡信息

```text theme={null}
使用 $speedpay-open-api-integration，帮我在测试环境接入 Visa card-info 接口。请先说明请求字段、签名步骤和敏感数据处理要求，再给出 Go 示例。
```

### 处理 JCB 回调

```text theme={null}
使用 $speedpay-open-api-integration，帮我实现 JCB callback Webhook。请覆盖验签、幂等、重试响应和日志脱敏，并先说明任何需要我确认的高风险操作。
```

## 支持范围

| 范围      | 可协助内容                      |
| ------- | -------------------------- |
| 通用接入    | 环境选择、请求结构、签名与验签、错误处理       |
| Visa    | 卡申请、激活、查询、控制、充值与交易记录       |
| JCB 卡   | 卡申请、激活、查询、控制、密码、费用、转账与交易记录 |
| JCB 钱包  | 钱包地址与交易记录查询                |
| Webhook | Visa 与 JCB 回调验签、幂等和重试处理    |
| 上线      | 测试检查、生产配置核对与上线前安全确认        |

## 包内容

* `SKILL.md`：Skill 入口、工作流程和安全规则
* `agents/openai.yaml`：Agent Skills 客户端元数据
* `references/`：按接入领域整理的参考资料

## 安全边界

* 默认仅使用测试环境。
* 不将私钥、API 凭据或完整敏感卡数据写入代码、提示词、日志或示例。
* 发起生产请求、执行资金操作、修改卡状态或传输凭据前，必须先说明将执行的操作、影响和所用环境，并获得明确确认。