收款

概述

本文档介绍如何接入收款相关功能。主要包含汇入汇款通知接收、订单创建以及解付入账三个主要环节。

当你收到汇入汇款通知后需要创建订单，然后发起解付入账流程将创建的订单和汇入汇款通知关联起来。可以调用解付入账状态查询的接口查询状态。解付入账通过/失败/退款都会发送解付入账结果通知。

业务流程

汇入汇款

• 汇入汇款通知：webhook，用于接收汇入汇款的异步通知
• 监听 INWARD_REMITTANCE 类型的回调通知
• 通知内容包含汇入汇款的详细信息，其中 order_no 为收款单号，后续解付入账时需要使用

订单

订单创建

• 订单创建：该接口用于创建新的订单
• 系统返回订单id contract_order_no
• 请求参数中的请求号 request_id 用于追踪业务流程

订单更新

• 订单更新：该接口用于更新已创建的订单
• 请求参数中的请求号 request_id 为订单创建时的request_id
• 只能更新状态为可关联 RELATABLE 的订单

补充物流(发货)信息

• 补充物流(发货)信息：该接口用于补充订单的物流信息
• 请求参数中的请求号 request_id 为订单创建时的request_id
• 只能对状态为可关联 RELATABLE 的订单进行补充物流信息操作

订单状态查询

• 订单状态查询：该接口用于查询订单的状态
• 请求参数中的请求号 request_id 为订单创建时的request_id

解付入账

状态流转

发起解付入账

• 创建解付入账流程：该接口用于发起解付入账申请
• 请求参数需要包含：
  • recv_order_no：汇入汇款通知中的收款单号 order_no
  • relate_list[].contract_order_no：为订单创建时返回的订单id contract_order_no
• 解付入账申请一旦提交，不可撤销或修改

解付入账状态查询

• 解付入账状态查询：该接口用于查询解付入账的处理状态
• 请求参数中的 recv_order_no 为汇入汇款通知中的收款单号 order_no

监听解付入账结果

• 解付入账结果(通知)：webhook，用于接收解付入账的处理结果
• 监听 TRADE_SETTLE 类型的回调通知
• 通知内容中的收款单id recv_order_no 为汇入汇款通知中的收款单号 order_no

注意事项

• 汇入汇款通知和解付入账流程为一对一关系
• 当接收到汇入汇款通知后资金还未进入商户的币种钱包，需要解付入账流程到达已入账 CREDITED 状态后才正式入账
• 订单创建操作无需审核，同步返回可关联状态 RELATABLE
• 一个订单只要订单金额足够可以关联多个解付入账申请