环境对比
| 特性 | 沙盒环境 | 生产环境 |
|---|---|---|
| API 地址 | https://api-sbx.paymetrixpay.com/api | https://openapi.paymatrixpay.com/api |
| 资金流动 | 模拟，无真实资金 | 真实资金 |
| 商户 ID | 与生产环境不同（沙盒专用） | 正式商户 ID |
| API 密钥 | 沙盒专用密钥对 | 生产专用密钥对 |
| 支付渠道 | Sandbox 渠道（模拟） | 真实支付渠道 |
| 费用 | 免费 | 按签约费率 |
快速开始
1. 获取沙盒凭据
登录商户门户后，在「开发者设置」中切换到沙盒环境标签：- 沙盒商户 ID
- 沙盒 RSA 密钥对（或上传自己的沙盒公钥）
- 沙盒 API 地址
2. 配置沙盒 Webhook
为沙盒环境单独配置 Webhook 地址（建议用不同的回调 URL，便于区分测试与生产事件）。3. 发起测试交易
使用沙盒 API 地址和密钥，调用接口与生产环境完全一致。测试卡号
在沙盒环境测试银行卡支付时，可使用以下卡号模拟不同场景：| 卡号 | 场景 | CVV | 有效期 |
|---|---|---|---|
4242424242424242 | 支付成功 | 任意 | 未来日期 |
4000000000000002 | 支付被拒绝 | 任意 | 未来日期 |
4000000000000259 | 需要 3DS 验证 | 任意 | 未来日期 |
4000000000003222 | 3DS 验证成功 | 任意 | 未来日期 |
4000000000003155 | 3DS 验证失败 | 任意 | 未来日期 |
以上卡号基于 Stripe 测试卡号标准。不同支付渠道可能有额外的测试卡号。
测试场景
沙盒环境支持模拟以下场景：支付场景
- 支付成功（立即确认）
- 支付失败（余额不足）
- 支付处理中 → 成功（异步确认）
- 支付处理中 → 失败（异步失败）
- 3DS 认证流程
- 支付超时关闭
退款场景
- 全额退款成功
- 部分退款成功
- 退款失败（余额不足）
Webhook 场景
- 支付成功通知
- 支付失败通知
- 退款成功通知
- 退款失败通知
- 争议创建通知
使用调试点
在商户门户中，沙盒环境提供以下调试工具：- 测试 Webhook 发送：手动触发指定事件类型的测试推送
- Webhook 投递记录：查看最近投递历史和结果
- API 日志：查看最近 API 请求和响应（含签名校验详情）
注意事项
切换到生产环境
- 确认沙盒联调全部通过
- 将 API 地址切换为生产环境地址
- 将密钥切换为生产环境密钥
- 将 Webhook 地址切换为生产回调 URL
- 确认 IP 白名单已配置
- 先进行小金额真实交易验证
- 确认无误后正式上线