商户平台付款
商户平台付款
无需技术集成，登录商户平台即可向本地银行账户或电子钱包发起付款，支持小额付款（单笔 / 批量）与大额付款。
小额付款
进入商户平台的付款页面，页面分为「小额付款」与「大额付款」两个页签；小额付款支持单笔与批量创建。付款创建后即推送真实的打款交易。
图：付款列表 —— 页面顶部为「小额付款 / 大额付款」页签，下方为筛选条件与付款记录列表。
创建付款
点击创建，然后选择单笔付款或批量付款。
图：新建付款 —— 点击「创建」后弹出，可选择「单笔付款」或「批量小额付款」。
单笔付款：付款给单个银行或电子钱包账户。
- 选择单笔付款。
- 填写付款信息并确认创建。
批量小额付款：付款给多个银行或电子钱包账户，通过上传表格模板一次提交多笔。填写要求与常见报错见下文。
批量小额付款
批量小额付款用于一次性向多个收款人（银行账户或电子钱包）付款：下载标准 Excel 模板（不同国家模板有所不同，请下载对应国家模板），按格式填写收款信息后上传，系统自动完成校验并逐笔发起付款。
操作流程
| 步骤 | 操作 | 说明 |
|---|---|---|
| ① | 下载模板，填写收款数据 | 模板 Sheet 名为 Template，列名不可修改 |
| ② | 选择文件并提交 | 系统自动生成批次号并校验文件 |
| ③ | 输入 MFA 动态验证码 | 24 小时内最多输错 5 次，超限需联系管理员 |
| ④ | 系统解析并展示数据预览 | 文件进入异步处理阶段 |
| ⑤ | 在「批次上传记录」查看结果 | 可按批次查看提交数量、成功 / 处理中 / 失败笔数与金额汇总，并可下载明细 |
图：批次上传记录 —— 每个批次一行，显示提交数量、成功 / 处理中 / 失败笔数与金额汇总；操作列可查看详情或下载明细。
Excel 模板填写要求
模板列名与校验规则如下。报错信息中出现的英文名称即对应的模板列名（例如报 Beneficiary Name，就是「收款人姓名」这一列有问题）。
图：标准 Excel 模板 —— 表格列名与顺序固定，「Receiving Channel」等列带有下拉选项。
不要修改表头或数据格式。修改表头、增删列、改变单元格格式等都可能破坏文件结构，导致上传时校验失败、无法提交。
填写时建议通过单元格的下拉框手动选择（如「Receiving Channel」收款渠道）。下拉选项与平台支持的渠道一一对应，手动输入容易因名称不一致（如缺空格、大小写不同）而报 Receiving Channel 错误。
通用列
| 模板列名 | 是否必填 | 填写要求 |
|---|---|---|
Amount（金额） | 必填 | 数字，最多 2 位小数（印尼不能有小数）；各国上限见下表 |
Receiving Channel（收款渠道） | 视类型填写 | 填银行 / 电子钱包全称，须为该国家支持的渠道；泰国 PromptPay 类型留空 |
Beneficiary Account Number（收款账号） | 必填 | 银行账号或电子钱包账号；电子钱包有格式要求（见下表） |
Beneficiary Mobile（收款人手机号） | 视国家填写 | 印尼必填；其余国家选填，填写须符合该国格式 |
Beneficiary Name（收款人姓名） | 必填 | 收款账户户名。仅作记录与渠道透传，不校验其正确性与真实性 |
Payment Remarks（付款备注） | 视国家填写 | 阿联酋必填；姓名 + 收款人地址合计不超过 140 字符 |
Beneficiary Email（收款人邮箱） | 选填 | 填写时须为合法邮箱格式 |
Merchant Order Id（商户订单号） | 选填 | 不超过 50 字符且不能与历史订单重复，用于幂等防重；不填则系统自动生成 |
Beneficiary Address（收款人地址） | 选填 | 与姓名两列字数合计不超过 140 字符 |
国家专项列
| 模板列名 | 取值 | 使用规则 |
|---|---|---|
Beneficiary Account Type（收款账户类型） | BANK / PROMPTPAY / EWALLET / SBP | 泰国、俄罗斯必填（不填该行直接失败）；沙特、阿联酋按模板填写；菲律宾 / 印尼 / 马来 / 越南无需填写 |
Beneficiary Type（收款人类别） | NATIONAL_ID / MOBILE_NUMBER / EWALLET_ID / BANK_ACCOUNT / CARD_NUMBER | 泰国：PromptPay 必填、BANK 必须留空；俄罗斯必填 |
Beneficiary Category（收款人主体类别） | INDIVIDUAL（个人）/ ORGANIZATION（企业） | 仅俄罗斯必填 |
| 沙特专项列 | Receiver IBAN、Swift Code、Receiver Bank Address、Receiver English / Local First / Last Name | 缺失会报 xxx is required |
泰国组合规则（不满足该行失败）
| 收款账户类型 | 要求 |
|---|---|
BANK | Beneficiary Type 必须留空；Receiving Channel 必填 |
PROMPTPAY | Receiving Channel 必须留空；Beneficiary Type 必填（NATIONAL_ID 或 MOBILE_NUMBER） |
俄罗斯组合规则（不满足该行失败）
| 收款账户类型 | 要求 |
|---|---|
| 所有类型 | Beneficiary Category、Beneficiary Account Type、Beneficiary Type 三列均必填 |
SBP | 账号必须是 10 位、9 开头的手机号；Receiving Channel 必填 |
EWALLET | Beneficiary Type 必须为 EWALLET_ID；Receiving Channel 必填 |
BANK + BANK_ACCOUNT | Receiving Channel 必填 |
BANK + CARD_NUMBER | Receiving Channel 必须留空 |
各国金额上限与手机号格式
| 国家 | 单笔金额上限 | 手机号要求 | 电子钱包账号要求 |
|---|---|---|---|
| 菲律宾 PH | 50,000 PHP | 选填；填了须 09 开头 11 位 | 09 开头 |
| 印尼 ID | 250,000,000 IDR | 必填，08 开头 10–13 位；金额不能有小数 | 08 开头 |
| 泰国 TH | 50,000 THB | 选填；填了须 0 / 6 / 8 / 9 开头 10 位 | 系统自动补前导 0 |
| 马来 MY | 50,000 MYR | 选填；填了须 01 开头 | 01 开头；TNG 钱包只需非空 |
| 阿联酋 AE | 55,000 AED | 无强制格式 | — |
| 沙特 SA | 37,500 SAR | 须为 5XXXXXXXX / 9665XXXXXXXX / 05XXXXXXXX | — |
| 俄罗斯 RU | 500,000 RUB | 无强制格式 | SBP 见上方组合规则 |
| 越南 VN | 300,000,000 VND | 无强制格式 | — |
系统还会自动处理以下情况，无需商户操作：银行 / 钱包名称填全称时自动转换为内部简称；菲律宾 / 印尼 / 马来 / 泰国的钱包账号缺前导 0 时自动补齐；金额、姓名、账号、渠道、邮箱、备注六列全为空的行自动忽略，不算失败。
常见报错与处理
Failure Reason（单行失败）文件已上传成功，但某一行校验未通过或付款失败，显示在该笔订单的 Failure Reason 字段；其余行不受影响，修正后重新上传新文件即可（只需包含需要重付的行）。
在「批次上传记录」中点击下载，可导出批次明细；明细中的 Status 与 Failure Reason 两列会给出每一行的处理结果与失败原因。
图：批次明细下载结果 —— Status 列显示 Failed，Failure Reason 列给出具体失败原因（如 Beneficiary Mobile","Receiving Channel 表示这两列未通过校验）。
失败原因若直接显示为某个模板列名（如 Amount、Beneficiary Name、Receiving Channel），表示该列内容未通过基础校验，直接检查该列即可。
金额与余额类
| Failure Reason | 问题 | 处理 |
|---|---|---|
| Amount | 金额为空或不是数字（最多 2 位小数） | 按格式修正该行金额 |
| The amount cannot be greater than xxx | 超过该国单笔金额上限 | 降低金额或拆分为多笔 |
| The amount cannot be blank | 金额为空 | 补充金额 |
| Insufficient balance | 商户账户余额不足。余额按文件行顺序逐行校验，因此可能前面的行成功、后面的行失败 | 充值后重新上传失败的行 |
收款渠道类
| Failure Reason | 问题 | 处理 |
|---|---|---|
| Receiving Channel | 收款渠道无效：常见银行 / 钱包名称在该国不存在或匹配不上 | 核对渠道名称与该国支持下拉列表一致 |
| Invalid: Receiving Channel must be empty for PromptPay | （泰国）PromptPay 类型填了收款渠道 | 该列留空 |
收款账号与手机号类
| Failure Reason | 问题 | 处理 |
|---|---|---|
| Beneficiary Account Number | 收款账号为空 | 补齐必填列 |
| Recipient Account Number | 电子钱包账号格式错误（菲 09 / 印尼 08 / 马来 01；俄罗斯 SBP 须 10 位 9 开头） | 按对应国家格式修正 |
| mobile format is invalid | 手机号不符合该国格式；印尼手机号为空也会报此错 | 按国家格式修正 |
收款人信息类
| Failure Reason | 问题 | 处理 |
|---|---|---|
| Beneficiary Name | 该列为空（只校验是否填写，不校验是否与户名一致） | 补齐必填列 |
| Beneficiary Email | 邮箱格式不合法 | 修正或留空 |
| Payment Remarks | （阿联酋）付款备注为空 | 补填备注 |
| Beneficiary Account Type / Missing: ... is required | （泰国 / 俄罗斯）收款账户类型为空 | 补填 BANK / PROMPTPAY / EWALLET / SBP |
| Beneficiary Type | 收款人类别值不在允许范围内 | 按上文取值修正 |
大额付款
大额付款需先创建大额收款人并完成审核，再向该收款人发起付款。
大额付款功能默认不开启，如需开通请联系您的客户经理。
创建大额收款人
- 进入大额收款人页面，点击创建。
- 填写收款渠道、收款人名称、收款人账号与简称。
- 上传双方的合作合同作为附件。
- 填写备注，简要说明双方的业务关系及付款原因。
- 点击提交，等待审核。
图：创建大额收款人 —— 需填写收款渠道、收款人名称 / 账号、简称，并上传合作合同与备注。
审核通过后，该收款人即可用于发起大额付款。
发起大额付款
- 进入大额付款页签，点击创建。
- 选择审核通过的大额收款人，填写商户订单号（非必填）、付款金额与付款备注。
- 输入 MFA 验证码并确认，付款即推送至打款。
图：创建大额付款 —— 选择已审核的大额收款人，填写金额与备注，确认后发起付款。
付款与订单状态
付款为异步处理，交易达到最终状态后，可通过以下方式获取结果：
| 获取方式 | 说明 |
|---|---|
| 回调通知 | PayCools 会向商户在平台上配置的回调地址发送通知 |
| 平台查看 | 登录商户平台，直接查看每笔付款的交易状态 |
批量小额付款可在付款列表按批次查看结果，各状态含义如下：
| 状态 | 含义 | 是否终态 |
|---|---|---|
| PENDING | 已提交，尚未处理完 | 否 |
| COMPLETED | 付款完成 | 是 |
| FAILED | 校验未通过或付款失败 | 是 |
失败订单的款项不会扣除（仅渠道侧已受理但最终失败的个别场景以渠道最终结果为准，款项会退回）。