跳转至

API 准备

要使用我们的网页端登录入口或 API,您需要以下凭证和配置信息。

账户设置

如需创建测试账户,您的公司必须提供一个固定公网 IP 地址和有效的电子邮箱。

API 凭证

下表列出了由 Cactus Custody 提供的相关凭证。

CredentialDescriptionUsage & Notes
ukey又称 Yubico Key:一种硬件身份验证设备。ukey 在设置过程中会绑定到您的用户账户。用于登录、订单审批等操作。

获取方式:
1. 提供您的收货地址,我们将寄送给您(需支付设备及运费)。
2. 或可直接在 Amazon 或其他授权渠道自行购买
apikey用于访问 API将此API Key填写到您的配置文件中。
akid由托管系统生成的标识符,用于签名验证和身份认证。它唯一绑定到某个操作员。API 请求的权限由该操作员的权限决定。获取方式:
1. 以管理员身份登录网页。
2. 进入 用户管理。
3. 点击 ≡ 图标并选择 API 公钥。
4. 上传您生成的 PEM 格式公钥文件。点击此处查看生成公钥的步骤。
5. 对应用户将通过电子邮件收到 akid。
wallet_code钱包 ID:您钱包的唯一标识符。配置路径: 管理员登录 → 业务线管理 → 配置。
仅管理员可申请和配置钱包。
b_id业务线 ID:标识您在系统中的业务线。查看路径: 管理员登录 → 业务线管理。

网络配置

IP 白名单

出于安全考虑,只有在白名单内的 IP 地址才能访问测试环境。测试环境 网页端登录入口

  • 要求: 提供固定公网 IP 地址。
  • 替代方案: 如果没有固定 IP,可通过代理访问系统。
  • 查看您的 IP: 访问 https://checkip.amazonaws.com/ 查询您的公网 IP。

回调配置(可选)

回调 URL

callback_url 用于接收充值和提现交易的通知。 此步骤为可选,视您的业务需求而定。

  • 配置方式: 通过网页端登录入口填写所需的回调 URL。
  • 配置路径: 管理员登录 → 业务线管理 → 管理 API → 填写回调 URL。