# 收款人及付款

## 概述

本文档介绍如何接入收款人管理和付款功能。通过这些接口，您可以管理收款人信息并执行付款操作。

付款前需要先创建**收款人**，**收款人**为**付款流程**中的收款方，你为**付款流程**中的付款方。

## 业务流程

### 收款人管理

#### 收款人状态

Description of image
#### 创建收款人

- [收款人创建](/collection/apis/openapi/收款人/create)：该接口用于创建新的收款人信息。
- 系统返回收款人ID `payee_id` 和状态，后续发起付款时需要。
- 请求参数中的请求号 `request_id` 用于追踪业务流程。


#### 修改收款人

- [收款人修改](/collection/apis/openapi/收款人/update)：该接口用于被驳回时修改收款人信息。
- 请求参数中的 `request_id` 为创建收款人时的 `request_id`。


#### 查询收款人状态

- [查询收款人状态](/collection/apis/openapi/收款人/inquiry_1)：该接口用于查询收款人的审核状态。
- 请求参数中的 `request_id` 为创建收款人时的 `request_id`。


#### 监听收款人创建结果通知

- [收款人创建结果(通知)](/collection/apis/openapi/收款人/notification_1)：**webhook**，用于接收异步通知。
- 监听 `PAYEE` 类型的回调通知
- 通知内容中的 `request_id` 为发起付款时的 `request_id`


### 付款流程

#### 付款状态

Description of image
#### 发起付款

- [付款](/collection/apis/openapi/付款/inquiry_3)：该接口用于发起付款申请，可计算手续费，如需换汇会返回汇率信息。
- 请求参数中的收款人id **beneficiary_id** 为收款人流程中创建成功的收款人id `payee_id`
- 请求参数中的请求号 `request_id` 用于追踪业务流程


#### 查询付款结果

- [付款状态查询](/collection/apis/openapi/付款/status)：该接口用于获取付款结果信息。
- 请求参数中的 `request_id` 为付款阶段发起付款时的 `request_id`


#### 监听付款结果通知

- [付款结果通知](/collection/apis/openapi/付款/notify)：**webhook**，用于接收异步通知。
- 监听 **PAYMENT** 类型的回调通知
- 通知内容中的 `request_id` 为付款阶段发起付款时的 `request_id`


## 注意事项

- 金额说明
  - 所有金额都使用币种最小单位
  - 例如：100.50 USD 应该传入 10050
- 付款操作
  - 付款前请确保收款人状态为 `NORMAL`