> ## Documentation Index
> Fetch the complete documentation index at: https://doc.haipay.net/llms.txt
> Use this file to discover all available pages before exploring further.

# HaiPay 常见问题与排查

> 汇总 HaiPay 使用过程中的高频问题、常见报错和配置排查建议，帮助商户快速自助定位问题。

本文档收录了 HaiPay 使用时遇到的各种常见问题，如果您在使用 HaiPay 的时候遇到了问题，请您优先查看本文档。

## 通用

> [accordion] 登录了haipay之后这边除了首页之外没有了任何功能。
>
> 需要用主账号再给之前的子账号角色授权下。

> [accordion] 拉起支付时报错，错误信息：No permission to pay for products, please contact the administrator
>
> 可能原因：
>
> 1. 客户的产品配置不对
> 2. 客户请求的支付方式不对

> [accordion] 拉起支付时报错，响应体：
>
> ```json theme={null}
> {"status":"0","error":"4002","msg":"system:channel code does not exist"}
> ```
>
> 渠道配置错误。

> [accordion] 客户付款时报错，提示身份验证失败。
>
> 可能原因：触发了银行的风控机制，所以被拒绝了，可以尝试换张卡重试。

> [accordion] 电话号码格式是什么？
>
> * 台湾：以 09 开头，总共包括 10 位数字。例如：09XX XXX XXX
> * 韩国：以 01X 开头，总共包括 10 位数字。例如：010 XXXX XXXX。
> * 比利时：以 04 开头，总共包括 10 位数字。例如：04XX XX XX XX。
> * 奥地利：以 06 开头，总共包括 9 位数字。例如：0664 XXXXXXX。
> * 德国：以 01 开头，总共包括 11 位数字。例如：0151 XXXXXXXX。
> * 波兰：以 5、6、7、8、9 开头，总共包括 9 位数字。例如：5XX XXX XXX。
> * 印尼：以 08 开头，总共包括 10 位数字。例如：081X XXXX XXXX。
> * 菲律宾：以 09 开头，总共包括 11 位数字。例如：09XX XXX XXXX。
> * 新加坡：以 8 或者 9 开头，总共包括 8 位数字。例如：8XXX XXXX 或者 9XXX XXXX。
> * 越南：以 09 开头，总共包括 10 位数字。例如：09XX XXX XXX。
> * 泰国：以 08 开头，总共包括 10 位数字。例如：08XX XXX XXX。
> * 马来西亚：以 01 开头，总共包括 10 位数字。例如：01X XXX XXXX。
> * 巴西：以 9 开头，总共包括 11 位数字。例如：9XXXX XXXX。
> * 俄罗斯：以 9 开头，总共包括 10 位数字。例如：9XX XXX XX XX。
> * 日本：以 0 开头，总共包括 11 位数字。例如：0XX XXXX XXXX。
> * 埃及：以01开头，总共包括 11 为数字。例如：01X XXXX XXXX。
> * 墨西哥：需验证，总共包括 10 位阿拉伯数字。例如：5512345678。
> * 孟加拉：以01开头，第三位为3-9，总共包括 11 为数字。例如：013 XXXX XXXX。

> [accordion] 部分支付方式无法唤醒APP，如何处理？
>
> ![支付方式唤醒 APP 失败时的 WebView 拦截处理示意图](https://mintcdn.com/haipay-3385f6e8/qslC2gsg_E8Updwu/images/common/guide/webview-unknown-url-scheme-zh.png?fit=max\&auto=format\&n=qslC2gsg_E8Updwu\&q=85\&s=2513ef0a423d90df0ed7e9f35ff0f180)
>
> ```java theme={null}
>     //需要做webview拦截处理
>     @Override
>     public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
>         if (request.getUrl().toString().startsWith("http")) {
>             view.loadUrl(request.getUrl().toString());
>             return super.shouldOverrideUrlLoading(view, request);
>         } else {
>             view.onPause();
>             view.stopLoading();
>             try {
>                 Intent intent = Intent.parseUri(uri, Intent.URI_INTENT_SCHEME);
>                 intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
>                 view.getContext().startActivity(intent);
>             } catch (URISyntaxException e) {
>                 //alert not support this scheme } 
>                 return false;
>             }
>         }
> }
> ```

## 台湾

> [accordion] 超商、ATM收款是否有异常？成功率低。
>
> 你好，我们查看后，超商和ATM支付没有异常，我们看下订单，一个用户有多笔订单，所以有些用户可能不会及时去缴款。
> 超商跟ATM属于线下支付服务，超商跟ATM都有区间缴款时间，成功率是取决于用户去支付的笔数。

## 巴西

> [accordion] 请问CDD里关于"现金来源"这一栏需要填什么内容?
>
> 游戏运营。

> [accordion] PIX代收下单失败，提示FAILED-invalid cpf or cnpj。
>
> 可能是未传CPF导致。

## ACH / ECASHAPP

> [accordion] 测试代付申请接口 name 和accountNo 是需要真实的账户吗？
>
> 名字可以传随机的 收款账号传真实的。

## 商户下发代付

> [accordion] 充值流程是怎样的？
>
> 1. 登录后台后，点击「财务管理 - 充值」，可以选择充值美元。
> 2. 填写充值金额，并上传转账成功的凭证。

> [accordion] 充值有哪些注意事项？
>
> 2.1 充值前请确认您的充值金额，确保输入金额与实际转账金额一致。
>
> 2.2 支付成功后，请务必上传清晰可辨的支付成功凭证。
>
> 2.3 充值前请先在群里联系我们，核实并确认后台显示的收款账号信息，确保资金转入正确账户。充值金额到账后，我们会在您的账户中增加对应的余额。
>
> 2.4 充值时间：我们的工作人员将在收到凭证后尽快处理您的充值请求。
>
> 2.5 如遇任何充值问题或有其他疑问，请及时联系我们的客服团队进行咨询，客服在线时间为 7×24 小时。

> [accordion] 开户前或使用过程中如何绑定/更换登录邮箱？
>
> 2.1 在账户激活之前，您需要提供一个电子邮件地址，该地址将用于后台登录验证。
>
> 2.2 主账户：若要更改主账户的登录邮箱，请联系我们的运营团队寻求帮助。
>
> ![商户绑定邮箱示意图](https://mintcdn.com/haipay-3385f6e8/qslC2gsg_E8Updwu/images/zh/guide/merchant-email-binding.png?fit=max\&auto=format\&n=qslC2gsg_E8Updwu\&q=85\&s=f024f52672d228e943a016fb838044a0)
>
> 2.3 子账户：如果您正在使用子账户，可以通过前往"设置中心 - 安全 - 电子邮件"手动更新您的电子邮件地址。

> [accordion] 如何发起单笔代付？有哪些注意事项？
>
> 3.1 在「业务管理 - 付款下发」功能下，可发起单笔付款。
>
> 注意事项：
>
> * 首次操作手工代付，建议先测试一笔小额订单，熟悉操作后再进行其余金额的手工代付。
> * 币种选择：确保选择正确的币种进行代付。
> * 请根据收款方账户的实际情况，选择正确的账户类型，例如银行账户或电子钱包。
>
> 重要提醒：
>
> * 请务必输入正确的收款账号，任何错误都可能导致资金打入错误账户，造成不必要的麻烦和损失。
> * 输入您希望代付的确切金额，注意不要超过您账户余额或任何已设定的限额。
> * 在提交代付请求前，请再次确认所有填写的信息无误。
> * 请妥善保管您的登录信息和邮箱验证码，不要与他人分享，以防账号被未授权访问。

> [accordion] 如何发起批量代付？有哪些注意事项？
>
> 3.3 在「业务管理 - 付款下发」中点击「发起批量代付」，按以下步骤操作：
>
> 1. 下载代付模板，并根据模板要求填写收款账号等信息。
> 2. 首次发起批量代付时，可先填写一笔金额较小的订单，熟悉流程后再进行后续批量操作。
> 3. 上传模板后，如果存在填写错误，可以下载带有错误提示的文件，根据提示修改正确后重新上传。
> 4. 上传成功后，请关注订单状态，避免重复发起提交。

> [accordion] 代付成功后如何获取打款凭证？
>
> 4.1 在「业务管理 - 付款下发」中，代付成功的订单在最右侧会展示「凭证」按钮。\
> 点击「凭证」即可下载或查看打款成功凭证。\\
>
> ![凭证下载示意图](https://mintcdn.com/haipay-3385f6e8/qslC2gsg_E8Updwu/images/zh/guide/payment-receipt-download.png?fit=max\&auto=format\&n=qslC2gsg_E8Updwu\&q=85\&s=ecee90fb4d6b53de6a3d10cd2c3406f3)

> [accordion] 在哪里可以查看资金明细和手续费？
>
> 5.1 在「财务管理 - 资金明细」中，可以查看每笔交易的手续费、资金变动等明细记录。\
> 系统支持导出 Excel 文件，方便您进行对账和留存。

## 相关主题

* [HaiPay 错误返回说明](https://doc.haipay.net/docs/zh/V20260623/guide/error_response_appendix.md)
* [HaiPay 端到端测试指南](https://doc.haipay.net/docs/zh/V20260623/guide/end_to_end_testing.md)
* [HaiPay 集成步骤指南](https://doc.haipay.net/docs/zh/V20260623/guide/integration_guide.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.