API 准备¶
要使用我们的网页端登录入口或 API,您需要以下凭证和配置信息。
账户设置¶
如需创建测试账户,您的公司必须提供一个固定公网 IP 地址和有效的电子邮箱。
API 凭证¶
下表列出了由 Cactus Custody 提供的相关凭证。
| Credential | Description | Usage & 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。