准备
要使用我们的网页端登录入口或 API，您需要以下凭证和配置信息。
开始前的准备
如需创建测试账户，您的公司必须提供一个固定公网 IP 地址和有效的电子邮箱。 下表列出了由 Cactus Custody 提供的相关凭证。
| 项目/凭证 | 说明 | 用途与备注 |
|---|---|---|
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。
API IP 白名单
此步骤用于在生产环境访问 API。 管理员需为每个 API 用户配置一个固定 IP 地址。若 IP 不正确，API 请求将返回错误。
配置路径： 管理员登录 → 用户管理 → ≡ → API IP 白名单
[!NOTE|style:flat] 仅管理员可配置 API IP 地址。
回调配置（可选）
回调 URL
callback_url 用于接收充值和提现交易的通知。
此步骤为可选，视您的业务需求而定。
- 配置方式： 通过网页端登录入口填写所需的回调 URL。
- 配置路径： 管理员登录 → 业务线管理 → 管理 API → 填写回调 URL。