常见问题
FAQ
常见问题
以下是接入过程中常见的问题及解答，按类别分组便于查阅。
账号与登录
第一次登录商户后台如何绑定 MFA
第一次登录会弹出绑定 MFA 的页面：
- 根据手机系统下载安装 Authenticator（若已安装可跳过）
- 用 Authenticator 扫描页面右方二维码绑定 MFA
- 查看 Authenticator 中的 MFA 码并输入即可
后续登录直接查看 MFA 即可，无需再次绑定。如需重新绑定请联系技术支持进行重置。
商户账号被锁定、重置密码、重置 MFA
请将商户登录账号发送至技术支持群，并告知是测试环境还是生产环境的商户账号。
测试环境下进行支付不成功或遇到页面错误
目前测试环境需要在商户后台进行模拟支付，不能像真实环境那样支付。
模拟支付时交易找不到，Transaction not found
请按以下顺序排查：
- 检查右上角国家是否对应
- 检查产品是否对应
- 检查 mchOrderId 是否正确
- 检查参数中的 appId 是否正确
支付与渠道
The mobile format is invalid
菲律宾：09 开头，共 11 位印尼：08 开头，共 10-13 位马来西亚：01 开头，共 10-11 位泰国：06/08/09 开头，共 10 位俄罗斯：9 开头，共 10 位
Merchant channel is unavailable
请将请求和响应参数发送至技术支持群。
线上测试动态码及 WebPay 登录付款无法支付
动态码有过期时间，可重新生成一笔订单尝试。WebPay 支付链接点击后未完成登录付款会返回支付失败，可重新生成一笔尝试。
如果仍然失败，请将二维码、支付链接、请求和响应参数发送至技术对接群。
测试环境下测试代付返回商户余额不足
需要在商户后台发起充值操作，然后联系技术支持进行审核。
授权代扣拿到 payToken 之后，付款接口是哪个
调用收款-下单接口。
签名与参数
请求签名错误
签名字符串不一致，请检查以下可能原因：
- 排序问题（主要是 PII 国际系统）
- 加签方式不一致
- 传递了额外参数
- 核实
Content-Type是否为application/json— 必须使用 JSON 传输，否则会导致获取不到参数 - 上传的公钥和签名的私钥不是同一对，或上传的公钥包含空格/换行符
请求金额问题
- 金额不是整数
- 金额不在渠道限额范围内
- 金额太小：印尼单位可理解为元（传参无需 ×100，建议至少传入 10000 IDR）；其他国家单位理解为分（传参需 ×100，如菲律宾 1 PHP 需传入 100）
customerName、email、mobile 业务上无法进行收集
该字段为渠道强制要求字段，不校验信息真实性，仅校验格式，可填写公司信息。
Channel Code、payMethodCode、Transfer Code 怎么传
请在文档中找到对应的表格，传入表格中对应的枚举值即可。
回调
回调需要返回什么数据？回调次数和回调间隔是多少
- 不处理 body 中的信息，异常情况需抛出非 200 的 HTTP 状态码
- 回调频率：前 10 分钟每分钟通知一次，超过 10 分钟后每小时通知一次
- 超过一天的交易，不会根据状态码自动回调