收款人及付款

概述

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

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

业务流程

收款人管理

收款人状态

创建收款人

• 收款人创建：该接口用于创建新的收款人信息。
• 系统返回收款人ID payee_id 和状态，后续发起付款时需要。
• 请求参数中的请求号 request_id 用于追踪业务流程。

修改收款人

• 收款人修改：该接口用于被驳回时修改收款人信息。
• 请求参数中的 request_id 为创建收款人时的 request_id。

查询收款人状态

• 查询收款人状态：该接口用于查询收款人的审核状态。
• 请求参数中的 request_id 为创建收款人时的 request_id。

监听收款人创建结果通知

• 收款人创建结果(通知)：webhook，用于接收异步通知。
• 监听 PAYEE 类型的回调通知
• 通知内容中的 request_id 为发起付款时的 request_id

付款流程

付款状态

发起付款

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

查询付款结果

• 付款状态查询：该接口用于获取付款结果信息。
• 请求参数中的 request_id 为付款阶段发起付款时的 request_id

监听付款结果通知

• 付款结果通知：webhook，用于接收异步通知。
• 监听 PAYMENT 类型的回调通知
• 通知内容中的 request_id 为付款阶段发起付款时的 request_id

注意事项

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