用途
setup-chip 用于 CHIP Collect 支付集成工作，可帮助完成设置、构建、调试和解释 CHIP Collect 支付集成。当用户需要处理 CHIP Collect 相关任务时使用该技能。
主要能力
该技能基于官方 CHIP Collect API 文档提供事实性 API 指导与集成代码编写支持。在给出 API 指导或编写集成代码前，应先阅读 references/chip-collect-docs.md，其中包含已下载的 CHIP Collect markdown 页面以及来自 https://docs.chip-in.asia/chip-collect/overview/introduction 的内嵌 OpenAPI 块。当用户询问如何注册、需要哪些 API 密钥、凭证来源或仪表板设置要求时，应阅读 references/account-setup.md。
核心事实包括：
- 基础 URL：https://gate.chip-in.asia/api/v1/
- 认证：每个请求使用 Authorization: Bearer <secret key>
- 凭证：API key 和 Brand ID 来自门户中的 CHIP Collect Developers 页面
- 金额：货币值使用最小货币单位。例如 price: 100 等于 RM 1.00
- 创建结账/支付链接流程：POST /purchases/，然后使用响应中的 checkout_url
- 支付状态选项：success callback、GET /purchases/{id}/ 或 webhook 事件
- 测试卡：4444 3333 2222 1111 非 3DS，5555 5555 5555 4444 3DS，CVC 123，有效期 >= 当前月/年
- 回调签名：X-Signature 是对原始请求体的 SHA256 摘要进行 base64 RSA PKCS#1 v1.5 签名
- 成功回调公钥：GET /public_key/；webhook 公钥：Webhook.public_key
查找映射涵盖：
- Purchases：创建、检索、取消、捕获、charge token、退款、释放、重发发票、标记已支付
- Clients：创建/列出/检索/更新/删除，循环 token 列出/检索/删除
- Webhooks：创建/列出/检索/更新/删除
- 支付方式：GET /payment_methods/，通常带 brand_id 和 currency
- Direct post：intro、card、FPX、DuitNow QR、e-wallet
- 在线流程：payment link、pre-authorization、subscriptions、custom flow
- 账户/报表：balance、turnover、company statements
使用方式
使用参考 OpenAPI 块中的精确端点路径和请求字段。按文档保留 CHIP Collect 端点上的尾部斜杠。编写代码时，将密钥保存在环境变量中，切勿硬编码 API key 或 Brand ID。对于 webhook/回调，签名验证需要原始请求体。如果用户询问最新定价、法律条款、支持的方法或生产门户状态，应先核实实时文档。
适用场景
适用于需要接入、构建、调试或解释 CHIP Collect 支付集成的开发工作，包括创建支付链接、查询支付状态、处理回调与 webhook、管理客户与支付方式等。
限制
该技能依赖参考文档提供事实性指导；对于最新定价、法律条款、支持的方法或生产门户状态等动态信息，需先核实实时文档。资料中未提供其他限制说明。