> ## 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之后这边除了首页之外没有了任何功能。**
>
> 需要用主账号再给之前的子账号角色授权下。

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

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

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

> **电话号码格式是什么？**
>
> * 台湾：以 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。

> **部分支付方式无法唤醒APP，如何处理？**
>
> ![支付方式唤醒 APP 失败时的 WebView 拦截处理示意图](https://mintcdn.com/haipay-3385f6e8/bzbfpf1uH8h6Eq93/images/app.png?fit=max\&auto=format\&n=bzbfpf1uH8h6Eq93\&q=85\&s=14f110c9ed7c46203dccb93fd2b61c9a)
>
> ```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;
>             }
>         }
> }
> ```

## 台湾

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

## 巴西

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

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

## ACH / ECASHAPP

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

## 商户下发代付

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

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

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

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

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

> **代付成功后如何获取打款凭证？**
>
> 4.1 在「业务管理 - 付款下发」中，代付成功的订单在最右侧会展示「凭证」按钮。\
> 点击「凭证」即可下载或查看打款成功凭证。\\
>
> ![凭证下载示意图](https://mintcdn.com/haipay-3385f6e8/PA2rp5SNvgJiXM_G/images/%E5%87%AD%E8%AF%81%E4%B8%8B%E8%BD%BD.png?fit=max\&auto=format\&n=PA2rp5SNvgJiXM_G\&q=85\&s=b3f267793535e72bb90ade539c7d5ba6)

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

## 相关主题

* [HaiPay 错误返回说明](https://doc.haipay.net/zh/resources/error-responses.md)
* [HaiPay 端到端测试指南](https://doc.haipay.net/zh/testing/end-to-end.md)
* [HaiPay 集成步骤指南](https://doc.haipay.net/zh/get-started/integration-steps.md)


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