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

# Payout 钱包与覆盖范围

> Waffo 的第四个账户：Payout 钱包里放的是什么、资金如何进出、失败和被冲正的 Payout 如何回到你的结算账户、如何读它独立的账户历史，以及在哪里查看你签约了哪些 Payout 通道。

Waffo 的四个余额中有三个与收款相关。付款则使用第四个账户，它有自己独立的账本。本页介绍该账户，以及在哪里查看你签约可以付款的范围。创建和跟踪一笔 Payout，见 Payout FAQ。

## Payout 钱包是什么？它和我的结算账户有什么区别？

它持有的是已经离开你的结算账户、但尚未到达收款人的资金。Portal 把该余额标记为 **In Transit**。

| 账户 | Portal 菜单 | 持有内容 | 可提现？ |
| - | - | - | - |
| 待结算 | Settlement Account | 尚未结算的成功交易 | 否 |
| 结算账户 | Settlement Account | 已结算资金，按结算币种 | 是 |
| 保证金 | Reserve Account | 按你的合约扣留的金额 | 否 |
| **Payout 钱包** | **Payout Wallet** | 已用于仍在途 Payout 的资金 | **否** |

该钱包没有提现操作，也不是提现来源——提现只能从结算账户发起。它存在的意义是让在途的 Payout 资金保持可见，而不是从你的结算余额中凭空消失。

## 钱包里的钱是从哪来的？

来自同一签约主体下你的**结算账户**，在 Payout **提交**的那一刻转入——不是完成时。两个后果：

* **币种是协议的付款方币种**，不是收款人收到的币种。跨币种 Payout 会先换算成付款方币种，所以钱包及其历史以 Service → Payout 页面上显示的 **Currency Pair** 的出资一侧计价。
* **金额包含 Payout 手续费**——出资金额 = 换算后的 Payout 金额 + 该订单的手续费。这就是为什么钱包中的一行很少与 Payout 金额完全相等。

如果出资币种的结算余额不足以覆盖，单笔 Payout 会在创建时以余额不足的业务错误被拒绝，而不是排队。

## Payout 钱包页面显示什么？

两个标签页：**Payout Wallet**，每个钱包币种一张卡片，显示其 **In Transit** 余额；以及 **Account History**，即它的账本。钱包账户只在需要时才会创建，所以空页面表示尚未发生过 Payout 出资。该页面对已开通的账户可用——如果你在菜单中能看到它，就可以使用。

这里的 Account History 只覆盖 **Payout 钱包**，与 Settlement Account 下的 Account History 相互独立：一笔 Payout 会在两处都产生记录，且互不显示对方的记录。

每行包含 **Account No**、**Business ID**（单笔 Payout 为 `payoutOrderId`，批量 Payout 为批次 id）、**Business Type**——在本页面上始终为 *Payout*——**Direction**（*Credit* 进入钱包，*Debit* 离开钱包）、**Amount** 按方向带符号、保留 2 位小数、**Datetime** 为 UTC+8，以及 **Description**，说明该行是 Payout 的哪一段。

日期筛选默认为**最近一个月**，并有自由文本的 **Business ID** 搜索。导出范围上限为 **31 天**，浏览器端和服务端各校验一次。文件名为 `payout_account_history_{merchant id}_{start}_{end}.csv`，时间戳格式 `YYYYMMDDHHMMSS`（UTC+8），并增加了屏幕表格中没有的两列：**Account Type** 和 **Balance**（该笔变动之后的余额）。

## Description 里的几个值是什么意思？

记录成对出现，一对记录告诉你资金处于哪个阶段。

| Description | 含义 |
| - | - |
| **Payout Funding In** | 提交时从你的结算账户出资进入钱包 |
| **Payout Funding Out** | 提交时从钱包释放、流向该 Payout |
| **Payout Failed In** | Payout 到达失败终态；资金回到钱包 |
| **Payout Failed Out** | 这些资金离开钱包，回到你的结算账户 |
| **Payout Reverse In** / **Out** | 成功后被冲正的 Payout 对应的一对记录 |

两条出资记录在提交时同时入账，所以一个所有 Payout 都已到达终态的钱包，完全可能在一长串历史记录背后显示 In Transit 余额为零。

## Payout 失败了，手续费也会退给我吗？

Payout 金额一定会退回。手续费取决于失败发生在哪里：如果订单从未到达 Payout 渠道，手续费全额退回；如果已到达渠道之后失败，则只有当协议标记为 **Fee Refundable = Yes** 时手续费才会退回——这是 Service → Payout 页面上的一列，你可以在发送前按支付方式查看。不可退的情况下，退回的金额是出资金额**减去手续费**，且该订单的手续费状态显示为已扣除。

## 成功的 Payout 被冲正了会怎样？

一笔 Payout 在已经到达 `SUCCESS` 后仍可能被接收方退回。Waffo 会保持 `status` 为 `SUCCESS`，并增加 `subStatus` 为 `FULL_REVERSED` 或 `PARTIAL_REVERSED`；冲正的金额会记回到为该 Payout 出资的账户——即你的结算账户，以出资币种计。部分冲正只退回被冲正的部分，所以对账时要对照冲正金额而不是原 Payout 金额。

## 我可以向哪些国家、支付方式和收款人类型付款？

没有全局列表可供参考：覆盖范围按协议而定，你的范围在 Portal 的 **Service → Payout** 上。每一行是一个签约组合，包含 **Country/Region**、**Currency Pair**（付款方 → 收款方币种）、**Payment Method Type** 和 **Payment Method**、**Payment Option**、**Fees**、**Minimum Amount** 和 **Maximum Amount**（以付款方币种计）、**Fee Refundable**、**Validity Period**（协议起止日期）和 **Status**。筛选条件覆盖国家、支付方式类型、支付方式和状态。**Status** 为 **Initial**、**Active**、**Suspended** 或 **Terminated** 之一，只有 *Active* 可以交易——因未签约而被拒绝的 Payout 通常是协议不在 Active 状态，Validity Period 能告诉你它是否只是已经过期。

收款人类型在每个请求中通过 `payeeType` = `INDIVIDUAL` 或 `BUSINESS` 设置。某个支付方式接受个人、企业还是两者，属于协议内容而不是页面上的一列，所以如果某个支付方式拒绝其中一种，请向支持确认。

## Service → Payin 怎么看？为什么有些列没有？

按每个签约的支付方式，思路相同：**Payment Method Country**、**Product**、**Payment Method Type**、**Payment Method**、**Payment Option**、**Fees**、**User Fee**（向你的终端用户收取的费用）、**Settlement cycle**、**Minimum**/**Maximum Amount**、**Order Currency**（签约的收单币种）、**User Currency**（向付款人扣款的币种）、**Refundable**、**Refund Period**、**Additional Fields For Refunds**、**Status**——外加一个直接的 **Export**。

部分列是条件显示的，所以两个账户看到的表格不同：**User Fee** 只在有协议收取该费用时出现，此时 Refundable 单元格也会说明该用户费用是否可退；**Mini Apps Info** 只在有协议关联小程序时出现；**Order Expiry Customization** 只在适用于你的账户时出现；网关模式账户会隐藏 **Fees** 和 **Settlement cycle**。

**Refundable** 解码的是 API 以 `refundAllowed` 返回的同一个值：*No*、*Only Full Refund*、*Full Refund or One-time Partial Refund* 或 *Full Refund or Multiple Partial Refunds*。在构建多次退款逻辑前请先核对。Payin 状态在上述四个之外增加了 **Onboarding**；收银台缺少某个支付方式通常是协议不在 Active 状态。

***

钱包历史与结算账本对不上？
[联系支持](mailto:support@waffo.com)，附上 Business ID 列中的 `payoutOrderId` 或批次 id。


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