沙盒环境
TapTap IAP 支持在沙盒环境中测试支付功能接入。
测试流程
建议按以下流程完成 IAP 沙盒测试:
- 在开发者中心添加沙盒测试账号。
- 使用沙盒测试账号登录游戏,并在测试包中发起 IAP 购买。
- 在收银台选择「信用卡/借记卡」或已保存的测试卡作为支付方式。
- 根据当前订单实际使用的卡支付通道,使用下方对应的沙盒卡号完成支付测试。
1. 设置沙盒账号
进入开发者中心后台, 按照如下步骤设置和添加对应沙盒账号:

2. 发起 IAP 测试
在游戏测试包中使用已添加的沙盒账号登录,并发起一笔 IAP 购买。进入收银台后,选择需要验证的支付方式完成测试。
3. 确认信用卡/借记卡通道
收银台中展示的「信用卡/借记卡」会根据商品支付币种和服务端配置选择实际支付通道。当前默认 SGD、HKD、USD、EUR、GBP、JPY、AUD、CAD、NZD 等币种会使用 Alipay+ Card;其他支持卡支付的币种会使用 Stripe Card,实际以线上配置为准。
4. 使用 Stripe Card 测试卡号
Stripe Card 不支持 $0.5 以下的支付,测试商品时,请确保商品定价不低于 $0.5。更多测试卡号和场景请参考 Stripe 官方文档。
支付测试时,有效期填写未来日期,CVC 和其他表单字段可填写任意有效值。
常用卡号:
| 测试场景 | 卡号 | 说明 |
|---|---|---|
| 成功支付 | 4242424242424242 | Visa |
| 成功支付 | 5555555555554444 | Mastercard |
| 通用拒付 | 4000000000000002 | 返回 card_declined |
| 余额不足 | 4000000000009995 | 返回 insufficient_funds |
5. 使用 Alipay+ Card 测试卡号
Alipay+ Card 测试卡号来自 Alipay+ / Antom 测试卡文档。支付测试时,CVC、邮政编码、有效期可填写任意有效值;如果支付页面要求输入支付密码前两位,可填写任意两位数字。
常用卡号:
| 测试场景 | 卡号 | 说明 |
|---|---|---|
| 成功支付 | 4054695723100768 | 全球 Visa |
| 成功支付 | 5162774114974622 | 全球 Mastercard |
| 成功支付 | 9490220011669217 | 韩国 Hyundai |
| 异常模拟 | 4054692760174822 | 全球 Visa |
| 异常模拟 | 5162770472561357 | 全球 Mastercard |
也可以使用以下方式模拟其他异常:
- 使用无效月份,例如
13,模拟有效期月份错误。 - 使用两位 CVV,例如
99,模拟 CVC 错误。 - 将支付金额设置为
11、1100或1111,模拟风控失败。 - 使用卡号
4035501000000008,模拟 3D Secure 免验场景。