本文档将引导您完成 NUSDpay 平台的完整接入流程。

​
接入总览

推荐按以下顺序完成接入。各阶段的调用频率不同：阶段 ① 为一次性配置，阶段 ② 的结果可缓存，仅阶段 ③ 需在每笔交易中调用。
接入总览：一次性准备 → 初始化拉取 → 每笔交易

接入总览（点击放大）

阶段 ①② 的结果可长期保存：wallet_id 与密钥固定不变，链/币种枚举与费率配置修改频率较低。仅阶段 ③ 属于每笔交易的常规路径。
1

联系我们，创建账户

在使用任何 API 之前，您需要先联系我们创建账户并获取 wallet_id。
  1. 发送邮件至 [email protected]，提供公司/项目名称、联系人信息及业务场景简述
  2. 我们将为您创建钱包、绑定项目信息并分配管理员权限
  3. 完成后，您将收到专属的 wallet_id
wallet_id 为项目级固定值：每个项目对应一个 wallet_id，由我们分配。您只需将其保存在配置中，所有接口调用均传入该值，无需为终端用户创建钱包或维护用户与 wallet_id 的映射关系（终端用户收款通过获取充值地址按用户维度生成收款地址实现）。新增项目时，我们将为其分配新的 wallet_id。
详细说明请参阅 Wallet ID 申请与配置指南。
2

生成 API 密钥

获取 wallet_id 后，生成 API 密钥对用于接口鉴权。
  1. 按照指引生成 Ed25519 密钥对（公钥作为 API_KEY，私钥作为 API_SECRET）
  2. 将公钥提供给我们进行绑定
密钥生成方法请参阅 生成公钥和私钥。
3

平台配置

根据业务需求，确认以下配置项：链与币种 — 选择需要开通的链及币种，详见 支持的币种与公链。Webhook 回调 — 提供回调 URL 以实时接收交易状态更新，详见 Webhook 介绍。Payout 配置 — 如需使用付款功能，确认已开通对应链的 Payout 权限。
配置变更请联系技术支持处理，请勿自行修改以免影响业务运行。
4

了解请求规范

开始调用接口前，请阅读以下说明：

请求说明

请求头与身份验证

API 签名

签名计算方式

交易状态

各状态含义与流转

错误码

错误码与排查指南
5

接入开发

完成以上准备后，根据业务场景选择对应模块：

​
Payin（收款）

收款接入流程

收款接入流程（点击放大）

主要接口：

​
Payout（付款）

主要接口：

​
Checkout 收银台（可选）

如需为终端用户提供现成的支付页面，可集成 Checkout H5 页面。详见 集成 H5 页面。
如您仅通过 API 进行钱包管理和资产操作，无需集成 Checkout，可跳过此部分。

​
下一步

产品介绍

了解 NUSDpay 的完整产品能力。

沙箱测试

在测试环境中验证接入。