快速开始

沙盒测试

使用沙盒测试卡验证卡支付、3DS 场景、失败响应、订阅、token 支付与钱包支付。

在沙盒环境中使用以下测试卡验证支付流程。测试卡仅适用于沙盒环境，不要在生产环境使用，也不要用真实持卡人信息替换这些测试值。

表格中的“响应”表示用于验证成功或失败分支的典型响应。实际接口返回仍以沙盒环境的当前配置为准。

卡支付测试卡

使用这些卡号验证一次性扣款、3DS 认证流程、豁免场景、失败响应、订阅支付和 token 支付。

“3DS 测试场景”表示这些测试卡在沙盒中用于模拟的认证流程或豁免路径。Challenge flow 和 Frictionless flow 是 3DS 认证流程，Exemption 表示豁免场景；它们不是卡片本身的固定属性，也不代表同一国家/地区的所有交易都会触发相同结果。

卡号	国家和地区	卡组织	3DS 测试场景	响应	订阅	保存支付方式
`4000020951595032`	🇺🇸 `US`	Visa	Challenge flow	Success	支持	支持
`4761344136141390`	🇸🇬 `SG`	Visa	Exemption	Success	支持	支持
`4000319872807223`	🇺🇸 `US`	Visa	Frictionless flow	Success	不支持	支持
`4000128449498204`	🇺🇸 `US`	Visa	Frictionless flow	Do not honor	不支持	支持
`4021937195658141`	🇬🇧 `GB`	Visa	Frictionless flow	Insufficient funds	不支持	不支持
`4000164166749263`	🇮🇳 `IN`	Visa	Frictionless flow	Suspected fraud	不支持	不支持
`2221008123677736`	🇺🇸 `US`	Mastercard	Challenge flow	Success	支持	不支持
`5333302221254276`	🇹🇷 `TR`	Mastercard	Exemption	Success	不支持	不支持
`5333418445863914`	🇲🇽 `MX`	Mastercard	Frictionless flow	Success	不支持	不支持
`5109486948867999`	🇺🇸 `US`	Mastercard	Frictionless flow	Restricted Card	不支持	不支持
`4998170000000015`	🇧🇷 `BR`	Visa	Challenge flow	Success	不支持	不支持
`4998170000000023`	🇧🇷 `BR`	Visa	Challenge flow	Suspected fraud	不支持	不支持

在沙盒环境测试 Apple Pay 前，请先完成以下准备：

域名验证：通过 Web SDK 或 API 直连在自有页面展示 Apple Pay 按钮的，测试域名需先完成 Apple 域名验证（由商户自有 Apple Developer 账号或 Onerway 代为报备），见 Apple Pay 接入准备；收银台为 Onerway 托管页面，无需此步骤。
Sandbox 测试账户：在 App Store Connect 中创建 sandbox 测试账户；测试设备退出 iCloud 账户后，使用该测试账户登录。
设备国家与地区：将测试设备的国家与地区设置为 Apple Pay 沙盒支持、且与所用测试卡卡组织匹配的地区；中国大陆地区的 Wallet 仅支持银联测试卡。

测试卡由 Apple 提供并会整批更换，请直接使用 Apple Pay sandbox testing（中文版）页面上的最新测试卡，在测试设备的 Wallet 中手动添加。

测试 Google Pay 前，请使用 Google 账号加入 Google Pay 测试卡套件群组，加入后该账号的 Google Pay 会自动展示一组测试卡，无需手动添加。

币种与金额校验

在创建支付请求前校验交易币种、金额精度和支付方式能力，避免因金额不合法被拒绝。

收银台接入

服务端创建收银台支付，重定向客户至 Onerway 托管页面完成支付，并通过 Webhook 确认支付结果。