# Infini 法币付款 API

法币付款 API 支持组织从 Infini USD 余额向第三方银行账户进行 USD 付款报价、创建和查询。

所有接口均使用 `/v2/payouts` 前缀。请求必须通过 [HMAC-SHA256 鉴权](/docs/en/4-authorization)，并使用具有相应付款权限的 API Key。

`POST /v2/payouts` 不进入后台审批流。Infini 会完成最终的权限、合规、Quote、收款资料、限额及可用余额校验，然后立即开始执行付款。银行结算是异步过程，因此创建成功通常返回 `status=processing`；这不代表收款银行账户已经到账。

Version: 0.4.0

## Servers

[object Object]
```
https://openapi.infini.money
```

[object Object]
```
https://openapi-sandbox.infini.money
```

## Security

### InfiniHmac

[object Object]

Type: http
Scheme: basic

## Download OpenAPI description

 - [Infini 法币付款 API](https://developer.infini.money/_bundle/@l10n/zh/apis/payout.yaml)

## 报价

 - [POST /v2/payouts/quotes](https://developer.infini.money/zh/apis/payout/%E6%8A%A5%E4%BB%B7/createfiatpayoutquote.md): 校验一份银行收款资料，并返回有时效性的付款 Quote。需要 `payout.write` 权限。 第一期不提供独立的收款人资源，因此收款资料直接随 Quote 提交。Infini 会将标准化且不可变的收款资料快照绑定到 `quote_id`；创建付款时不能替换或修改这份资料。 第一期只支持以下金额模式与手续费承担方组合： - `amount_mode=send` 与 `fee_paid_by=B
## 付款

 - [POST /v2/payouts](https://developer.infini.money/zh/apis/payout/%E4%BB%98%E6%AC%BE/createfiatpayout.md): 使用有效 Quote 创建付款并立即开始执行。需要 `payout.write` 权限，且付款不会进入后台审批流。 `quote_id` 已经绑定服务商、收款资料快照、来源和目标币种、付款通道、金额模式、手续费承担方、汇率、金额和费用明细，因此本请求不重复提交这些字段。 本接口会执行具有最终效力的付款前校验，包括 API Key 归属与权限、Quote 归属与有效期、请求与 Quote 一致性、账
 - [POST /v2/payouts/status/batch](https://developer.infini.money/zh/apis/payout/%E4%BB%98%E6%AC%BE/batchgetfiatpayoutstatuses.md): 返回当前鉴权组织在 `start_time` 至 `end_time`（包含边界）内创建的法币付款。需要 `payout.read` 权限。 结果按创建时间倒序排列并使用页码分页。`page` 默认值为 `1`；`page_size` 默认值为 `20`，最大值为 `100`。 按时间窗口定期对账时使用此接口；查询一笔已知付款时使用 `GET /v2/payouts/{payout_id}`。
 - [GET /v2/payouts/{payout_id}](https://developer.infini.money/zh/apis/payout/%E4%BB%98%E6%AC%BE/getfiatpayout.md): 返回当前鉴权组织的一笔付款最新状态。需要 `payout.read` 权限。 `processing` 表示仍在执行；`completed` 表示付款已成功完成。对端银行仍可能拒收并退回一笔已经完成的汇款；原付款继续保持 `completed`，可选的 `return` 对象会描述银行退汇和独立退款。`failed` 表示付款在银行成功完成前失败。