> For the complete documentation index, see [llms.txt](https://docs.musepay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.musepay.io/cn/ji-cheng/webhook/fiat-payout.md).

# Fiat Payout（法币出款）

本页说明法币出款订单的终态通知。创建接口成功只表示请求已受理，最终结果以通知或查询为准。

通知以 HTTP POST 发送。请按[配置和重试约定](/cn/ji-cheng/webhook.md)验签、幂等处理并返回 HTTP 200。不要把此通知格式与查询接口的响应格式混用。

## 通知 Body

| 参数                | 类型          | 说明                                                                           |
| ----------------- | ----------- | ---------------------------------------------------------------------------- |
| partner\_id       | String      | MusePay 分配的合作伙伴账户 ID。                                                        |
| customer\_ref\_id | String      | 客户关联 ID，有值时返回。                                                               |
| order\_no         | String      | MusePay 订单号。                                                                 |
| request\_id       | String      | 合作伙伴提供的订单请求号。                                                                |
| order\_type       | String      | 交易类型，参见[订单类型](/cn/api-can-kao/enums/order-type.md)。                          |
| product\_code     | String      | 交易产品编码。                                                                      |
| currency          | String      | 订单通知中的币种代码。                                                                  |
| order\_amount     | String      | 请求的订单金额。                                                                     |
| pay\_amount       | String      | 实际支付金额。                                                                      |
| fee\_amount       | String      | 服务费金额。                                                                       |
| settle\_currency  | String      | 结算币种代码。                                                                      |
| actual\_amount    | String      | 以 settle\_currency 计价的实际结算金额。                                                |
| finish\_time      | String      | 通知所取订单的更新时间，以 Unix 毫秒时间戳字符串返回。                                               |
| status            | Number      | 终态订单状态：99（成功）、44（失败）、88（关闭）。参见[订单状态](/cn/api-can-kao/enums/order-status.md)。 |
| reason            | String      | 失败或关闭原因，有值时返回。                                                               |
| extra\_info       | JSON String | 包含订单可选扩展字段的 JSON 字符串。                                                        |
| sign              | String      | Base64 编码签名，参见 [Webhook 配置](/cn/ji-cheng/webhook.md)。                        |

金额字段均为十进制字符串。出款的支付金额与法币结算金额可能采用不同币种；`actual_amount` 以 `settle_currency` 计价，不应直接与 `pay_amount` 相减。

## Extra Info

`extra_info` 是 JSON 字符串，需再次解析。以下字段均为可选，按实际订单数据返回；空字符串字段不返回。字段名区分大小写。

### 通用字段

| 参数            | 类型     | 说明                  |
| ------------- | ------ | ------------------- |
| payType       | String | 支付类型。               |
| paymentMethod | String | 订单支付方式。             |
| productName   | String | 支付关联的商品名称。          |
| customerRefId | String | 合作伙伴提供的客户关联 ID。     |
| description   | String | 请求中的描述信息。           |
| remark        | String | 订单备注。               |
| email         | String | 订单关联的电子邮箱。          |
| exchangeRate  | String | 订单记录的汇率，需结合订单交易对理解。 |
| symbol        | String | 汇率对应的交易对。           |
| rateTime      | Number | 汇率时间，Unix 毫秒时间戳。    |

### 出款与收付款账户字段

| 参数                       | 类型     | 说明                                       |
| ------------------------ | ------ | ---------------------------------------- |
| country                  | String | 出款关联的国家。                                 |
| payerAccount             | String | 付款账户。                                    |
| payerAccountName         | String | 付款账户持有人名称。                               |
| payerBankSwiftCode       | String | 付款银行 SWIFT 代码。                           |
| beneficiaryName          | String | 收款人名称。                                   |
| beneficiaryBankCode      | String | 收款银行代码。                                  |
| beneficiaryWallet        | String | 收款钱包标识。                                  |
| beneficiaryAccountNumber | String | 收款账号。                                    |
| beneficiaryAccountType   | String | 收款账户类型。                                  |
| beneficiaryEmail         | String | 收款人电子邮箱。                                 |
| beneficiaryPhoneAreaCode | String | 收款人电话国家或地区区号。                            |
| beneficiaryPhone         | String | 收款人电话号码。                                 |
| documentId               | String | 订单记录的身份证件号码。                             |
| documentType             | String | 订单记录的身份证件类型。                             |
| bankRoutingCode          | String | 银行路由代码。                                  |
| userInfo                 | Object | 法币出款相关的扩展信息，键和值均为字符串；具体内容随出款业务而异，可能为空对象。 |