从密钥到第一笔付款.
创建 API 密钥
在 Moove Business 中为 Moove Receive Agent 创建密钥。密钥只显示一次，请立即存入您的环境变量。创建付款链接
一次 POST 即返回结账 URL。客户在该页面用任意链上的任意代币付款。付款即时通知
注册一个 HTTPS 端点，链接一旦付款，Moove 会立即向其发送签名事件。
API 精简，保障可靠.
任意代币付款，结算为您的代币
客户用手中持有的资产付款，覆盖 30+ 区块链网络。每笔付款都会以您选择的代币和链结算到您的钱包。可放心构建的 API 契约
版本号写在路径中，v1 只做新增，并提供实时更新的 OpenAPI 规范。限制清晰，错误明确
按密钥和 IP 限流，超限返回简单的 429，统一的错误格式配合稳定的错误码。API 本身不收费.
无订阅费，也不按调用次数收费。客户若用其他代币或链付款，由其承担 0.02%，您可全额到账。- API 访问
- 免费
- 同一代币、同一网络
- 免费
- 跨代币或跨网络
- 0.02%
Moove 与自行开发对比.
| Moove 与自行开发对比。 | Moove | 自行开发 |
|---|---|---|
| 支持的链 | Moove: 30+ 条链，一个端点搞定 | 自行开发: 每条链单独集成 |
| 转换为您的代币 | Moove: 每笔付款均已内置 | 自行开发: 自建兑换与跨链桥路由 |
| 确认款项到账 | Moove: 签名 Webhook 和列表端点 | 自行开发: 每条链都要自行运行监听服务 |
| 结账页面 | Moove: 托管链接，随时分享 | 自行开发: 自行设计、开发和托管 |
| 如果密钥泄露 | Moove: 只能发起向您付款的请求 | 自行开发: 热钱包里的全部资产 |
常见问题.
如何获取 API 密钥？
登录 Moove Business 控制台，打开“API 密钥”。为密钥命名并选择 Moove Receive Agent，它授予创建和读取付款链接的权限。完整密钥只在创建时显示一次，之后不会再显示，请将其存入密钥管理工具。没有用于创建密钥的端点，因此一个密钥永远无法签发另一个密钥。
客户付款后，资金去哪里？
进入密钥所有者的默认钱包，使用该钱包的链和结算代币。调用方无法指定其他收款地址。因此，首次调用前，账户需要已注册的 Moove handle，以及设置了结算代币的默认钱包；缺少任一项，创建链接都会返回 409，提示账户尚未准备好收款。
有出款 API 吗？
暂时没有。该 API 只收款，不付款。如需立即向供应商或承包商付款，请使用 Moove Business 控制台中的“发送”。Moove Send Agent 已经发布预告，上线后将出现在文档中。
Moove Webhook 如何运作？
在控制台中最多可注册五个 HTTPS 端点。每个端点接收两种事件：一种在某个链接的付款结算时发送，另一种在链接完成时发送。推送使用仅显示一次的密钥，以 HMAC-SHA256 签名。推送保证至少送达一次，请按事件 ID 去重。推送失败后最多重试六次。
有速率限制吗？
有。请求按 API 密钥和来源 IP 分别限流，以先达到的上限为准，超限返回 429。被拒绝的请求同样计数，因此不要立即重试，而应采用带随机抖动的指数退避。请通过 Webhook 获取付款状态，而不是轮询单个链接；如果多个集成共用一台主机，请按 IP 上限规划请求量。
API 如何进行版本管理？
版本号写在路径中。目前只有一个公开版本：v1。同一版本内的变更只做新增：新端点、新的可选字段、新的响应字段。任何可能导致客户端出错的变更，例如删除字段或更改类型，都会以新的路径版本发布。请让客户端忽略未知字段，并依据错误码而非错误信息进行分支处理。
