跳转到主要内容
在 Localpayment 沙盒中安全地测试智能字段。模拟支付并验证集成,然后再正式上线。 在正式上线之前,测试您的 智能字段 集成至关重要。Localpayment 沙盒环境可让您安全地模拟真实场景,帮助您验证前端和后端流程。

Stage 环境

使用沙盒环境和测试 API 密钥进行集成:
请确保在应用程序中使用 正确的 API 密钥 和 Stage SDK URL:
  • API密钥: 为测试环境和生产环境分别生成API密钥。
  • 域名验证: 如果请求来自未注册的域名,则会话初始化将失败,并触发“无效源域名”错误。
  • 仅供模拟: 沙盒交易模拟支付流程,不涉及真实资金流动。

测试卡号

使用以下测试卡号模拟不同的支付场景:
  • 有效期: 使用任何有效的未来日期。
  • CVV: 任何3位数的CVV码均可接受。
  • 持卡人姓名: 任何姓名均可接受。

错误模拟

通过模拟潜在问题来测试错误处理能力:

无效卡号

  • 场景: 使用 4242424242424241。
  • 结果: 触发 change 事件,且 isValid 为 false。

过期卡

  • 场景: 使用过去的到期日期,例如 2020 年 12 月。
  • 结果: 令牌化失败,出现过期错误。

会话过期

  • 场景: 在 initializeSession() 之后等待超过 10 分钟。
  • 结果: 由于会话过期,令牌化失败。

网络错误

  • 场景: 暂时断开网络连接。
  • 结果: 由于网络错误,令牌化失败。
请确保您的集成监听并响应 error 事件,并提供适当的用户反馈和重试选项。

完整测试示例

使用完整的示例页面验证您的集成:
请从 localhost 运行该示例。将 localhost 添加为 Smart Fields API 密钥 的允许域名,以避免域名验证错误。
最后修改于 2026年11月10日