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

<Accordion title="拉起支付时报错，错误信息：No permission to pay for products, please contact the administrator">
  可能原因：

  1. 客户的产品配置不对
  2. 客户请求的支付方式不对
</Accordion>

<Accordion title="拉起支付时报错，响应体：">
  ```json theme={null}
  {"status":"0","error":"4002","msg":"system:channel code does not exist"}
  ```

  渠道配置错误。
</Accordion>

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

<Accordion title="电话号码格式是什么？" id={"zh_faq_phone-number-format"}>
  * 台湾：以 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 位阿拉伯数字。例如：1234567890。
  * 孟加拉：以01开头，第三位为3-9，总共包括 11 为数字。例如：013 XXXX XXXX。
</Accordion>

<Accordion title="部分支付方式无法唤醒APP，如何处理？">
  <img src="https://mintcdn.com/haipay-3385f6e8/JVdma2QzfkiRdMRn/images/app.png?fit=max&auto=format&n=JVdma2QzfkiRdMRn&q=85&s=10814b585458613d00e6357c2a05e0dc" alt="支付方式唤醒 APP 失败时的 WebView 拦截处理示意图" width="332" height="197" data-path="images/app.png" />

  ```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>

## 台湾

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

## 巴西

<Accordion title="请问CDD里关于&#x22;现金来源&#x22;这一栏需要填什么内容?">
  游戏运营。
</Accordion>

<Accordion title="PIX代收下单失败，提示FAILED-invalid cpf or cnpj。">
  可能是未传CPF导致。
</Accordion>

## ACH / ECASHAPP

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

## 商户下发代付

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

<Accordion title="充值有哪些注意事项？">
  2.1 充值前请确认您的充值金额，确保输入金额与实际转账金额一致。

  2.2 支付成功后，请务必上传清晰可辨的支付成功凭证。

  2.3 充值前请先在群里联系我们，核实并确认后台显示的收款账号信息，确保资金转入正确账户。充值金额到账后，我们会在您的账户中增加对应的余额。

  2.4 充值时间：我们的工作人员将在收到凭证后尽快处理您的充值请求。

  2.5 如遇任何充值问题或有其他疑问，请及时联系我们的客服团队进行咨询，客服在线时间为 7×24 小时。
</Accordion>

<Accordion title="开户前或使用过程中如何绑定/更换登录邮箱？">
  2.1 在账户激活之前，您需要提供一个电子邮件地址，该地址将用于后台登录验证。

  2.2 主账户：若要更改主账户的登录邮箱，请联系我们的运营团队寻求帮助。

  <img src="https://mintcdn.com/haipay-3385f6e8/JVdma2QzfkiRdMRn/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=JVdma2QzfkiRdMRn&q=85&s=a8e80d33f2a7ca98433bdaba34726429" alt="商户绑定邮箱示意图" width="2549" height="1069" data-path="images/商户绑定邮箱.png" />

  2.3 子账户：如果您正在使用子账户，可以通过前往"设置中心 - 安全 - 电子邮件"手动更新您的电子邮件地址。
</Accordion>

<Accordion title="如何发起单笔代付？有哪些注意事项？">
  3.1 在「业务管理 - 付款下发」功能下，可发起单笔付款。

  注意事项：

  * 首次操作手工代付，建议先测试一笔小额订单，熟悉操作后再进行其余金额的手工代付。
  * 币种选择：确保选择正确的币种进行代付。
  * 请根据收款方账户的实际情况，选择正确的账户类型，例如银行账户或电子钱包。

  重要提醒：

  * 请务必输入正确的收款账号，任何错误都可能导致资金打入错误账户，造成不必要的麻烦和损失。
  * 输入您希望代付的确切金额，注意不要超过您账户余额或任何已设定的限额。
  * 在提交代付请求前，请再次确认所有填写的信息无误。
  * 请妥善保管您的登录信息和邮箱验证码，不要与他人分享，以防账号被未授权访问。
</Accordion>

<Accordion title="如何发起批量代付？有哪些注意事项？">
  3.3 在「业务管理 - 付款下发」中点击「发起批量代付」，按以下步骤操作：

  1. 下载代付模板，并根据模板要求填写收款账号等信息。
  2. 首次发起批量代付时，可先填写一笔金额较小的订单，熟悉流程后再进行后续批量操作。
  3. 上传模板后，如果存在填写错误，可以下载带有错误提示的文件，根据提示修改正确后重新上传。
  4. 上传成功后，请关注订单状态，避免重复发起提交。
</Accordion>

<Accordion title="代付成功后如何获取打款凭证？">
  4.1 在「业务管理 - 付款下发」中，代付成功的订单在最右侧会展示「凭证」按钮。\
  点击「凭证」即可下载或查看打款成功凭证。\\

  <img src="https://mintcdn.com/haipay-3385f6e8/JVdma2QzfkiRdMRn/images/%E5%87%AD%E8%AF%81%E4%B8%8B%E8%BD%BD.png?fit=max&auto=format&n=JVdma2QzfkiRdMRn&q=85&s=bf7a49c61c36f273da3f486d737dc985" alt="凭证下载示意图" width="552" height="98" data-path="images/凭证下载.png" />
</Accordion>

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

## 相关主题

* [HaiPay 错误返回说明](/docs/zh/guide/error_response_appendix)
* [HaiPay 端到端测试指南](/docs/zh/guide/end_to_end_testing)
* [HaiPay 集成步骤指南](/docs/zh/guide/integration_guide)