环境

SlaunchX 提供两个独立的 API 集成环境：用于开发和测试的 沙箱环境 和用于实际运营的 生产环境。两个环境暴露相同的 API 接口和认证机制，但它们完全隔离——数据、API 密钥和配置不会跨环境共享。

环境 URL

	沙箱环境	生产环境
API 基础 URL	https://sandbox.api.lampay.app	https://api.lampay.app
管理面板	https://sandbox.dashboard.slaunchx.cc	https://dashboard.slaunchx.cc
用途	开发、测试、质量保证	实际交易、真实资金
数据	模拟的，可重置	持久的，真实的

从沙箱开始

始终先在沙箱环境中构建和测试您的集成。只有在端到端验证完您的实现后，才切换到生产环境。

认证

两个环境使用相同的 HMAC-SHA256 认证 机制。但 API 密钥是 环境特定的——沙箱 API 密钥不能在生产环境中使用，反之亦然。

项目	沙箱环境	生产环境
API 密钥前缀	sk_test_	sk_live_
API 密钥	每个环境唯一	每个环境唯一
认证机制	HMAC-SHA256	HMAC-SHA256

您可以在各自的管理面板中独立生成和管理每个环境的 API 密钥。

沙箱特性

沙箱环境专为安全、无风险的开发设计：

• 模拟交易 -- 所有转账和钱包操作都是模拟的。不会移动真实资金。
• 测试数据 -- 预置的测试钱包和账户可立即使用。
• 即时处理 -- 在生产环境中可能需要时间的交易，在沙箱中会即时处理。
• 可重置状态 -- 沙箱数据可以从管理面板重置，而不影响生产环境。
• 完整的 API 覆盖 -- 每个生产环境端点在沙箱中都可用，且请求/响应格式完全相同。

测试凭证

获取沙箱 API 密钥

1. 登录 沙箱管理面板。
2. 导航到 设置 > API 密钥。
3. 点击 创建 API 密钥 并分配所需的权限范围。
4. 复制 API 密钥（sk_test_...）和 API 密钥。密钥仅显示一次。

测试钱包

沙箱环境预置了测试钱包。您也可以通过 API 或管理面板创建额外的钱包。所有沙箱钱包都以可配置的测试余额开始。

测试卡号 / 钱包地址

如果您的集成涉及外部支付方式，以下测试值可在沙箱中使用：

类型	值	行为
测试钱包（成功）	预置的 w_test_* 钱包	交易正常成功
测试钱包（余额不足）	余额为零的钱包	返回 W3001（INSUFFICIENT_BALANCE）
测试钱包（已冻结）	已冻结的测试钱包	返回 W1003（ACCOUNT_FROZEN）

与生产环境的差异

虽然沙箱尽可能地镜像生产环境，但仍存在一些差异：

方面	沙箱环境	生产环境
速率限制	更宽松	标准速率限制适用
数据持久性	数据可能会定期重置	完全持久
Webhooks	投递到您配置的端点，格式相同	相同
交易处理	即时，模拟	真实处理时间
监控和告警	有限	完整的运维监控

:::caution 沙箱数据不是永久的 沙箱数据可能会在维护窗口期间被重置。不要依赖沙箱数据进行长期存储或记录保存。 :::

上线检查清单

在将您的集成从沙箱切换到生产环境之前，请完成以下步骤：

1. 替换 API 密钥 -- 将 sk_test_ 凭证替换为 sk_live_ 生产凭证。不要硬编码密钥；使用环境变量或密钥管理器。

2. 更新基础 URL -- 将 API 基础 URL 从 https://sandbox.api.lampay.app 更改为 https://api.lampay.app。

3. 验证 webhook 端点 -- 确保您的生产 webhook 接收器已部署、可公开访问，并已在生产管理面板中配置。

4. 使用小额真实交易测试 -- 运行几笔小额交易以确认端到端的正确性，然后再大规模处理。

5. 启用生产监控 -- 为 API 错误（5xx 响应）、延迟峰值和 webhook 投递失败设置告警。

6. 检查 IP 白名单 -- 如果您使用 IP 白名单，请确保您的生产服务器 IP 已添加到生产 API 密钥配置中。

7. 确认幂等性处理 -- 验证您的重试逻辑使用幂等键以防止生产环境中的重复交易。

代码示例

基于配置在沙箱和生产环境之间切换的环境感知客户端设置：

后续步骤

• API 集成概述 -- SlaunchX API 的工作原理以及入门所需。
• HMAC 认证 -- API 请求签名的分步指南。
• 错误处理 -- 响应信封格式和错误码目录。