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

# 出款

* 支持向全球 180 多个国家和地区、30 多种币种出款，包括向中国大陆出款 CNY。
* 你可以使用自己的实体作为付款人，也可以代表子账户发起出款（POBO，代付）。详见：[COBO & POBO](/zh/global-account/v1.6/guide/cobo-pobo)
* 你可以在发起出款之前预先创建[收款方（受益人）](/zh/global-account/v1.6/guide/recipients-beneficiary)，以简化和加速整个出款流程。

<h2 id="supported-regions-and-currencies">支持的国家/地区和币种</h2>

* 请参阅[支持的国家/地区和币种](/zh/global-account/v1.6/guide/supported-regions-and-currencies)

<h2 id="payout-status-flowchart">出款状态流程图</h2>

```mermaid theme={null}
flowchart TD
    A(("提交出款"))
    RTS["状态：READY_TO_SEND<br><small>出款已通过校验，准备开始处理。</small>"]
    PEN["状态：PENDING<br><small>系统正在处理该笔出款。</small>"]
    APP{"风控系统校验，通过 / 拒绝？"}
    RFIQ{"信息是否足够？"}
    RFI["RFI（请求补件）"]
    RFIA["商户补充信息"]
    REJ["状态：REJECTED<br><small>因未满足校验或合规要求，出款被拒绝。</small>"]
    FAI["状态：FAILED<br><small>出款处理过程中出错，未能完成。</small>"]
    PRO{"处理交易<br>成功 / 失败？"}
    COM["状态：COMPLETED<br><small>出款已成功处理，资金已完成划转。</small>"]
    CHA{"收款方响应<br>异常 / 完成？"}
    RET(("退款流程"))
    NRET(("无需退款"))

    A --> RTS
    RTS --> PEN
    PEN --> RFIQ
    RFIQ -- "NO" ---> RFI
    RFIQ -- "YES" ---> APP
    RFI --> RFIA
    RFIA --> RFIQ    
    REJ --> RET
    FAI --> RET
    APP -- "Rejected"---> REJ
    APP -- "Approved"---> PRO
		PRO -- "Success"---> COM
    PRO -- "Fail"---> FAI
    COM --> CHA
    CHA -- "Completed"---> NRET
    CHA -- "Abnormal"---> FAI
    


    %% Optional styling for clarity
    style PEN fill:#DBEDFB, color:#000000;
    style COM fill:#c8e6c9, color:#000000;
    style REJ fill:#ffcdd2,color:#000000;
    style FAI fill:#ffcdd2,color:#000000;
```

⚠️ 注意：`Completed` 状态并非终态，后续仍可能被更新为 `Failed`。

<h2 id="payout-time-sequence-diagram">出款时序图</h2>

```mermaid theme={null}
sequenceDiagram
    actor Merchant
    participant System
    participant RiskSystem
    participant Recipient

    Merchant->>System: 提交出款
    System->>System: 状态：READY_TO_SEND
    System->>System: 状态：PENDING
    System->>RiskSystem: 检查信息是否足够
    alt 信息是否足够？
        RiskSystem-->>System: 是
        System->>RiskSystem: 执行风控校验（通过 / 拒绝？）
        alt 风控校验结果
            RiskSystem-->>System: 通过
            System->>Recipient: 处理交易
            alt 交易结果
                Recipient-->>System: 成功
                System->>System: 状态：COMPLETED
                System->>Recipient: 核实收款方响应
                alt 收款方响应
                    Recipient-->>System: 完成
                    System->>System: 无需退款
                else 异常
                    Recipient-->>System: 异常
                    System->>System: 状态：FAILED
                    System->>System: 发起退款流程
                end
            else 失败
                Recipient-->>System: 失败
                System->>System: 状态：FAILED
                System->>System: 发起退款流程
            end
        else 被拒
            RiskSystem-->>System: 被拒
            System->>System: 状态：REJECTED
            System->>System: 发起退款流程
        end
    else 信息不足
        RiskSystem-->>System: 否
        System->>Merchant: RFI（请求补件）
        Merchant->>System: 提交补充信息
        System->>RiskSystem: 重新校验信息
    end
```

⚠️ 注意：`Completed` 状态并非终态，后续仍可能被更新为 `Failed`。

***

<h2 id="api-doc">API 文档</h2>

| 用途             | API / Webhook                                                            |
| -------------- | ------------------------------------------------------------------------ |
| 创建出款           | [Create Payout](/zh/global-account/v1.6/api-reference/create-payout)     |
| 查询单笔出款的最新状态和详情 | [Retrieve Payout](/zh/global-account/v1.6/api-reference/retrieve-payout) |
| 列出出款，用于历史记录或对账 | [List Payouts](/zh/global-account/v1.6/api-reference/list-payouts)       |
| 接收出款状态更新       | [出款状态 Webhook](/zh/global-account/v1.6/webhooks/payout-status)           |

集成说明：

* Create Payout 需要 `x-idempotency-key`；仅在同一笔出款发生客户端超时或不确定失败后重试时复用同一个 key。
* 对于 POBO 出款，请在 `x-on-behalf-of` 请求头中传入子账户 `account_id`。
* 你可以使用已有的 `beneficiary_id` 创建出款，也可以在请求中提供完整 `beneficiary` 信息。不要在同一个请求中同时传入两者。
* 创建出款前，可使用 [List Balances](/zh/global-account/v1.6/api-reference/list-balances) 或 [Retrieve Balance](/zh/global-account/v1.6/api-reference/retrieve-balance) 确认源账户有足够可用余额。出款处理后，如需核对余额变动，可使用 [List Balances Transactions](/zh/global-account/v1.6/api-reference/list-balances-transactions)。
* 对于跨币种出款，请先创建报价，并在出款请求中传入返回的 `quote_id`。