目录

申请分账回收

功能介绍

订单已经分账,可以调用此接口,将已分账的资金从分账接收方账户回退给收单方,再发起退款。

  • 回收金额不能超过分账金额。
  • 目前该接口一次请求只能支持回收一笔分账,一笔分账单支持多次分账回收。
  • 此接口为异步处理模式,即接收到商户分账回收申请后,会先受理再异步处理,最终结果会异步给商户。
  • 分账订单退款和分账回收并无强耦合关系。是否需要分账回收,由商户决定。商户余额充足的情况下,可以不发起分账回收,直接发起退款。

使用约束

换单重试,视为新的业务订单,需开发者自行将新的业务订单关联业务原订单。接口重入规则说明如下(供参考):

重入判定字段

支持原单重入场景

建议换单重试场景

商户分账回收订单号(mercReclaimOrderNo)

  1. 请求分账回收接口失败,建议根据错误码排查后,支持原商户分账回收订单号重入。
  2. 请求分账回收接口成功,原商户分账回收订单号重入,接口幂等返回。该笔订单状态以异步结果通知或同步查询接口里为准。

分账回收订单状态RECLAIM_FAILED,则订单进入失败终态。如需重新分账回收,需要换单重试。

接口原型

承载协议

HTTPS POST

接口方向

开发者服务器-> 华为支付服务器

接口URL

https://petalpay-developer.cloud.huawei.com.cn/api/v1/allocation/reclaim/orders

数据格式

请求消息:Content-Type: application/json

响应消息:Content-Type: application/json

请求参数

响应参数

错误码

(resultCode非400000的错误码请看公共错误码说明)

resultCode

resultDesc

subCode

subDesc

400000

业务处理失败

INVALID_ARGUMENTS

参数不合法

400000

业务处理失败

CHECK_ORDER_STATUS

订单状态异常

400000

业务处理失败

UNKNOW_ERROR

服务暂不可用,请稍后重试

400000

业务处理失败

ORDER_NOT_SUPPORT

订单不支持分账

400000

业务处理失败

CHECK_TRANSACTION_ORDER_STATUS

交易订单状态异常

400000

业务处理失败

NEED_CHANGE_ORDER

请换单重试

400000

业务处理失败

MERC_ORDER_NOT_EXIST

商户订单号不存在

400000

业务处理失败

ALLOCATION_FINISH

分账已完结

400000

业务处理失败

ALLOCATION_AMOUNT_ERROR

分账金额异常

400000

业务处理失败

INVALID_MERC_NO

无效商户号

400000

业务处理失败

CHECK_MERC_STATUS

商户状态异常

400000

业务处理失败

MERC_NOT_SUPPORT_ALLOCATION

商户不支持分账

400000

业务处理失败

CHECK_ALLOCATION_MERC

分账接收方商户号不合法