测试卡号

在 GoGoPay 沙箱环境中，您可以使用以下测试卡号来模拟各种支付场景， 无需使用真实的银行卡信息即可完成集成测试。

重要提示： 这些测试卡号仅在沙箱环境中有效，不会产生真实的资金流动。 在生产环境中使用这些卡号将会失败。

基本测试信息

除了卡号外，您还需要提供以下测试信息：

  • 过期日期：任何未来的日期（如 12/25）
  • CVC：任何 3 位数字（如 123）
  • 持卡人姓名：任何有效姓名
  • 邮政编码：任何有效邮政编码

成功支付测试卡

以下卡号将模拟成功的支付流程：

卡号 品牌 描述
4242424242424242 Visa 标准成功支付
4000056655665556 Visa (借记卡) 借记卡成功支付
5555555555554444 Mastercard 标准成功支付
5200828282828210 Mastercard (借记卡) 借记卡成功支付
378282246310005 American Express 标准成功支付
6011111111111117 Discover 标准成功支付
3056930009020004 Diners Club 标准成功支付
3566002020360505 JCB 标准成功支付

失败支付测试卡

以下卡号将模拟各种支付失败场景：

卡号 失败原因 错误代码
4000000000000002 卡片被拒绝 card_declined
4000000000000069 卡片过期 expired_card
4000000000000127 CVC 错误 incorrect_cvc
4000000000000119 处理错误 processing_error
4000000000000341 卡号错误 incorrect_number
4000000000000259 余额不足 insufficient_funds
4000000000000093 卡片丢失 lost_card
4000000000000087 卡片被盗 stolen_card

3D Secure 测试卡

以下卡号用于测试 3D Secure 认证流程：

卡号 3D Secure 行为 描述
4000000000003220 认证成功 3D Secure 认证成功后支付成功
4000000000003238 认证失败 3D Secure 认证失败
4000000000003246 认证不可用 3D Secure 服务不可用
4000000000003253 跳过认证 银行跳过 3D Secure 认证

特殊场景测试卡

以下卡号用于测试特殊的支付场景：

卡号 场景 描述
4000000000000077 需要身份验证 支付需要额外的身份验证
4000000000000010 地址验证失败 地址验证 (AVS) 失败
4000000000000028 邮政编码验证失败 邮政编码验证失败
4000000000000036 CVC 和 AVS 失败 CVC 和地址验证都失败
4000000000000044 风控拒绝 被风控系统拒绝

国际卡测试

以下卡号用于测试不同国家/地区的卡片：

卡号 国家/地区 货币
4000000400000008 美国 USD
4000000560000004 英国 GBP
4000000250000003 法国 EUR
4000000380000008 日本 JPY
4000000360000006 澳大利亚 AUD
4000000124000009 加拿大 CAD

测试流程建议

为了全面测试您的支付集成，建议按以下顺序进行测试：

  1. 基础功能测试
    • 使用成功支付卡号测试正常支付流程
    • 验证支付成功后的业务逻辑
    • 确认 Webhook 事件正确接收
  2. 错误处理测试
    • 使用失败支付卡号测试各种错误场景
    • 验证错误信息正确显示
    • 确认失败后的处理逻辑
  3. 安全功能测试
    • 使用 3D Secure 卡号测试认证流程
    • 验证安全认证的用户体验
    • 测试认证失败的处理
  4. 边界条件测试
    • 测试最小和最大金额
    • 测试不同货币
    • 测试网络异常情况

测试环境配置

确保您的测试环境正确配置：

// 沙箱环境配置 const gogoPayConfig = { apiKey: 'sk_test_...', // 测试环境密钥 apiUrl: 'https://sandbox-api.gogopay.com', webhookSecret: 'whsec_test_...', // 测试环境 Webhook 密钥 };

常见问题

问题 原因 解决方案
测试卡在生产环境失败 测试卡仅在沙箱环境有效 确认使用正确的环境配置
支付一直处理中 网络问题或配置错误 检查 API 密钥和网络连接
Webhook 未触发 Webhook URL 配置错误 检查 Webhook 配置和网络可达性
3D Secure 页面不显示 测试环境限制 使用指定的 3D Secure 测试卡

下一步

完成测试后，您可以：