WorldFirst DocsWorldFirst Docs

集成 Skill

万里汇现已将核心 API 对接能力封装为 Skill 组件，使 API 集成文档易于 AI 理解。开发者只需使用自然语言向 AI 工具描述集成需求，即可跳过复杂的底层签名逻辑和接口细节处理，让 AI 工具自动生成对应的集成代码，帮助开发者高效完成对接流程。

适用场景

该 Skill 组件适用于开发者在 Vibe Coding 的模式下集成万里汇 API 能力，当前支持的业务模块如下：

模块

说明

万里汇转账

在 WF 账户之间划转资金（咨询/发起/查询/结果通知）

全球分发（代发）

代发到第三方银行卡或电子钱包（咨询/发起/查询/结果通知）

收款人管理

卡模版查询、绑定/删除/编辑/查询收款人、绑定结果通知

账户管理

查询账户信息/余额/结汇额度/子账号/店铺，接收充值/余额变动通知

账单管理

查询账户交易流水列表及流水详情

交易信息管理

上传交易订单（B2C 结汇 / B2B 订单关联）、查询结果、处理异步通知

支持的编程语言

语言

支持范围

Java

覆盖所有模块

Golang

覆盖所有模块

Python

目前仅支持公共模块和账单管理模块。

集成准备

在开始安装集成 Skill 之前，请完成以下准备工作：

操作步骤

请按照以下步骤开始安装并使用集成 Skill：

步骤一：下载 Skill

此 Skill 遵循开放的 SKILL.md 标准，可无缝兼容 Claude、Cursor 等主流 AI 编程工具。您可选择从 GitHub 或通过 npx 下载此 Skill，并将 Skill 文件夹复制到项目路径 /.claude/skills/ 下即可使用。

注意：集成 Skill 将随着万里汇产品的更新进行同步迭代，建议您定期检查并更新至最新版本。

从 GitHub 下载

  1. 从 GitHub 下载最新的 Skill 源码。
  2. 将 wf-api-integration/ 文件夹放入编辑器的 skills 目录中，例如 .claude/skills/wf-api-integration/。

通过 npx 下载

执行以下命令以安装此 Skill：

copy
npx skills add https://github.com/ant-intl/wf-ai-tools/tree/main/wf-api-integration -y -g

步骤二：描述需求

  1. 启用 AI 工具，并使用自然语言向 AI 描述您的 API 对接需求，AI 将根据您的描述自动生成集成代码。
  2. 为了让 AI 更好的了解您的集成需要，请在与 AI 交互时明确指出需要集成的业务模块（如万里汇转账、全球分发、收款人管理等），以避免歧义。您可参考下表的示例描述：

业务场景

示例描述

万里汇转账

"帮我对接万里汇转账接口，实现 WF 账户之间的资金划转"

全球分发（代发）

"帮我集成万里汇代发接口，实现发工资到银行卡"

收款人管理

"帮我对接万里汇收款人管理，实现绑定和查询收款人银行卡"

账户管理

"帮我集成万里汇账户余额查询接口"

账单管理

"帮我对接万里汇账单流水查询接口"

交易订单管理

"帮我集成万里汇交易订单上传接口，用于 B2C 结汇"

  1. 在生成集成代码前，AI 会向您确认以下信息：
  • 项目路径和编程语言选择
  • Base Package / Module Name
  • WF Client ID、User ID、API 网关地址
  • RSA 私钥和公钥文件路径

注意：AI 工具生成的集成代码仅供参考。在部署到生产环境前，请务必审查代码逻辑。

步骤三：获取沙箱配置信息

  1. 登录 WorldFirst 开发者中心。
  2. 进入 WorldFirst 开发者中心 获取沙箱配置信息。
  3. 按以下格式将沙箱配置信息提供给 AI 工具：
copy
client-id：SANDBOX_xxxxxxxx
user-id：xxxxxxxx
api-base-url：https://open-sea.worldfirst.com
private-key-path：/path/to/private_key.pem
wf-public-key-path：/path/to/wf_public_key.pem

注意：

我们建议您在上线前完成以下准备工作：

  • 在万里汇沙箱环境中完成完整的 API 调用流程测试。您无需使用真实资金即可完成全链路验证。
  • 将沙箱配置替换为生产环境的正式凭证。

如需查看最新的文档变更，请参阅发版说明。