生产环境测试

GStable 仅在 主网 (Mainnet) 运行，以确保能够访问真实的链上流动性。我们不提供沙盒 (Sandbox) 或测试网环境。

本指南将介绍如何使用 “左口袋进右口袋” 策略，以最低的风险和成本验证您的集成。

生产环境

GStable 上的所有交易都涉及 真实资金。 这里没有测试资产。在配置金额时请务必小心。

为什么没有沙盒？

我们的支付基础设施旨在紧密反映真实使用情况的环境中运行。实际上，测试网或沙盒环境会引入巨大的摩擦，使得有意义的集成和验证变得困难：

1. 有限的资产可用性 标准稳定币和原生 Gas 代币在测试网上往往稀缺或分布不均。获取和维护这些资产会增加不必要的开销，并拖慢开发和测试进度。

2. 与生产环境条件不匹配 测试网环境在性能、可靠性和用户体验方面与主网存在显著差异。这些差距使得难以在真实条件下准确评估行为，从而增加了集成过程中的不确定性。

3. 更高的集成复杂性 由于许多生态系统功能和网络能力仅在主网上进行了优化或完全可用，依赖沙盒可能会引入额外的适配工作，而不是减少工作量。

基于这些原因，直接在类生产环境中工作提供了更清晰的信号、更低的集成门槛以及更具代表性的端到端体验。

测试策略：左口袋进右口袋

由于 GStable 采用 非托管 架构，资金直接从付款人流向商户。

当您测试一笔支付时：

1. 您扮演商户：资金到达您的自托管钱包。
2. 您扮演付款人：您从自己的加密钱包付款。
3. 结果：本金（如 $10）从您的“左口袋”移动到了“右口袋”。

您唯一的成本是网络 Gas 费和平台费 (~0.2%)。 您 不会 损失本金。

成本估算（示例）

项目	数值	说明
交易金额	$10.00	本金（回到您的钱包）
平台费 (0.2%)	$0.02	成本
Gas 费 (Base/Arbitrum)	~$0.01	成本
总成本	~$0.03	端到端验证的成本极低

集成检查清单

遵循此清单以安全地验证您的集成。

1. 前置准备

• 最小金额：确保您的测试金额至少为 $10 USD。由于 Gas 和路由限制，系统最低限额为 $10。
• 测试网络：建议使用 Base 或 Arbitrum 进行测试，因为 Gas 费较低。
• 测试资产：准备 USDC 或 USDT。

2. 创建测试商品

1. 进入商户后台 > Payment Links。
2. 创建一个新商品：
   • 名称：Integration Test Item
   • 价格：$10.00 (固定价格)
3. 生成支付链接 (Payment Link)。

3. 执行“同链”支付（推荐）

为了最大限度地减少费用和确认时间，请使用 同链 路径。

• 商户设置：确保您的收款账户支持 Base USDC。
• 付款人操作：使用有 Base USDC 的钱包进行支付。
• 路径：Base USDC -> Base USDC。
  • 费用：~0.2%
  • 速度：~ 30 秒

4. 验证成功

1. 前端：确认支付页面显示“支付成功”或正确跳转。
2. 仪表盘：检查订单状态更新为 Paid。
3. Webhook：验证您的服务器收到了 session.paid 事件。
4. 钱包：确认 $9.98 USDC（本金 - 费用）已到达您的商户钱包。

一旦此流程完成，您的集成即已针对所有支持的链和资产通过了全面验证。