收单交易测试
在测试环境中,为方便商户在对接过程中调试不同支付结果的处理流程,PayerMax 提供了完善的模拟策略;
商户联调时,通过选择支付方式,输入符合格式的支付信息进入模拟界面完成模拟支付;
测试环境不会真实扣款,用户账号信息只验证格式,不做账号真实性验证。
1. 集成模式模拟规则
需注意,您设置的测试金额必须在当前支付方式的限额范围内。
1.1 直联卡通用规则
- 支付方式:CARD、APPLEPAY、GOOGLEPAY。
下单参数subject
指定以下值可以mock支付结果:
- 成功:subject =
SUCCESS
或其他 - 失败:subject =
FAILED
- 支付中:subject =
PENDING
3DS mock:
subject = 3DS
支持的集成模式:纯API支付、前置组件;
支付方式:CARD;
3ds 页面选择认证成功则支付成功,选择认证失败则支付失败。
1.2 收银台支付及链接支付
1.2.1 APM
跳转URL交互: 产线跳转外部渠道页面,测试环境跳转到结果选择页。
- 支付方式列表:
国家 | 支付方式类型 | 目标机构 |
CN | WALLET | ALIPAY |
...... |
- mock方案:
跳转链路:
- 选择successful:跳转成功结果页,会发起回调通知,订单状态为
SUCCESS
; - 选择failed:跳转失败结果页。可点击结果页的Close按钮主动关单或者等订单到关单时间后,会发起回调通知,订单状态为
FAILED
; - 选择pending:跳转支付中结果页,订单到关单时间后会发起回调通知。
OTP交互:输入手机验证码后直接获取支付结果。
- 支付方式列表:
国家 | 支付方式类型 | 目标机构 |
SA | WALLET | STCPAY |
- mock方案:默认直接返回支付结果为成功,满足subject字段场景按对应结果返回。
下单参数subject指定以下值可以mock支付结果:
- 成功:
subject = SUCCESS
或其他 - 失败:
subject = FAILED
- 支付中:
subject = PENDING
1.3 纯API支付
1.3.1 APM
大部分支付方式下单返回
redirectUrl
,跳转url交互:产线跳转外部渠道页面,测试环境跳转支付结果选择页。- 支付方式列表:
国家 | 支付方式类型 | 目标机构 |
ID | WALLET | LINKAJA |
...... |
下单返回
qrCode
:- 支付方式列表:
国家 | 支付方式类型 | 目标机构 |
ID | BANK_TRANSFER | BCA/BRI/BTPN... |
BR | REALTIME_PAYMENT | PIX |
SG | REALTIME_PAYMENT | PAYNOW |
PH | REALTIME_PAYMENT | QRPH |
mock方案:下单返回qrCode,订单支付结果参考subject (
subject = SUCCESS
、subject = FAILED
)。下单返回
vaCode
:- 支付方式列表:
国家 | 支付方式类型 | 目标机构 |
TW | BANK_TRANSFER | YUSHANBANK/... |
TW | OTC | 7-ELEVEN/...... |
- mock方案:正常返回vaCode,订单支付结果参考subject (
subject = SUCCESS
、subject = FAILED
)。
1.4 前置组件
请参考【1.1 直联卡通用规则】。
1.5 Tokenization支付
用户首次支付时返回Tokenization:
收银台支付:请参考【1.2 收银台支付及链接支付】;
纯API支付:请参考【1.3 纯API支付】。
在后续支付时:
- 请参考【1.3 纯API支付】。
2. 用户账户信息模拟
2.1 APM
满足账号格式即可,部分可参考以下内容,其余可上网查询。
巴西 | 埃及 | 智利 | |
任一邮箱:Example@gmail.com | CPF(11位数字):12345678909 CNPJ(14位数字):12345678000195 | Mobile Number(01开头11位):01234567899 | CI:123456785 |
2.2 Card
卡支付,测试环境可使用的测试卡号:
Visa | Master | JCB |
---|---|---|
卡号:4444333322221111 | 卡号:5555555555554444 | 卡号:2131 4324 2974 3027 |
姓名:James Smith | 姓名:Allen Black | 姓名:James Smith |
有效期-年:30 | 有效期-年:26 | 有效期-年:30 |
有效期-月:03 | 有效期-月:11 | 有效期-月:03 |
CVV:123 | CVV:357 | CVV:123 |
沙特Mada | 科威特Knet | 卡塔尔Naps | 巴林Benefit | 巴基斯坦 |
---|---|---|---|---|
卡号:5297412542005689 | 卡号:4507785555554449 | 卡号:4215375500883243 | 卡号:5326774027281753 | 卡号:4919713330643198 |
姓名:William Harris | 姓名:Jacob Thomas | 姓名:Olivia Taylor | 姓名:Brown Jenny | 姓名:Patric berg |
有效期-年:30 | 有效期-年:26 | 有效期-年:26 | 有效期-年:30 | 有效期-年:2027 |
有效期-月:05 | 有效期-月:11 | 有效期-月:06 | 有效期-月:08 | 有效期-月:06 |
CVV:350 | CVV:357 | CVV:123 | CVV:927 | CVV/CVC:135 |
2.3 ApplePay
商户开发创建沙盒Apple账户,点击参考官方地址;
在收银台选择Apple Pay支付,拉起ApplePay支付表单;
ApplePay授权并支付完成后,根据
subject
字段返回支付结果。详情请参考【ApplePay测试环境模拟流程】。
注意:ApplePay支持的条件主要为以下2种,具体支持情况可以参考ApplePay官网。
- 苹果设备(MacBook,iPad,iPhone等)的safari浏览器上使用;
- 苹果自己的webview内核上使用。
2.4 GooglePay
在收银台选择Google Pay支付,拉起GooglePay支付表单;
在GooglePay支付表单中,登录您的GooglePay账户,您可以将您的Gmail账号添加到GooglePay测试卡套件中( https://groups.google.com/g/googlepay-test-mode-stub-data ) 用于下一步模拟支付;
GooglePay授权并支付完成后,根据
subject
字段返回支付结果,模拟支付成功或者失败。详情请参考 【GooglePay测试环境模拟流程】。
注意:
GooglePay不支持在WebView中拉起GooglePay sheet,建议使用默认浏览器打开。
3 请求API退款接口模拟
成功:除下面固定金额外任意金额;
失败-固定金额(本币):10000或102(大约1分钟后回调退款失败);
支付中-固定金额(本币):20000 或 202。