CloudPay.profitSharingReturnQuery()

支持端:云函数 2.0.2

回退结果查询

说明

应用场景

  • 商户需要核实回退结果,可调用此接口查询回退结果。
  • 如果分账回退接口返回状态为处理中,可调用此接口查询回退结果。

接口频率:30QPS 接口说明*

此接口与微信支付原分账接口(文档)的不同点在于:

  • 私有安全链路,免证书管理,免签名计算
  • 商户号填入 sub_mch_id 字段,小程序/公众号 appid 填入 sub_appid 字段
  • 免填写以下字段:mch_id、appid、sign、sign_type
  • 接口入参和返回值都为 JSON 而不是 XML

参数说明

名称变量名必填类型示例值描述
子商户号sub_mch_idstring(32)1900000109微信支付分配的子商户号
随机字符串nonce_strstring(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串,不长于32位。推荐随机数生成算法
微信分账订单号order_id与out_order_no二选一string(64)4208450740201411110007820472原发起分账请求时,微信返回的微信分账单号,与商户分账单号一一对应。
微信分账单号与商户分账单号二选一填写
商户分账单号out_order_no与order_id二选一string(64)P20190806125346原发起分账请求时使用的商户系统内部的分账单号。
微信分账单号与商户分账单号二选一填写
商户回退单号out_return_nostring(64)R20190806125346调用回退接口提供的商户系统内部的回退单号

返回值说明

名称变量名必填类型示例值描述
返回状态码return_codestring(32)SUCCESS枚举值:
SUCCESS:分账回退处理成功
FAIL:分账回退处理失败
错误代码error_codestring(32)SYSTEMERROR如果返回状态码为FAIL,则本字段存在,且为失败的错误码
详见错误码列表
返回信息error_msgstring(256)参数格式校验错误如果返回状态码为FAIL,则本字段存在,且为失败的错误信息

以下字段在return_code为SUCCESS的时候有返回

名称变量名必填类型示例值描述
商户号mch_idstring(32)1900000100调用接口时提供的商户号
子商户号sub_mch_idstring(32)1900000109微信支付分配特约商户的商户号
公众账号IDappidstring(32)wx8888888888888888调用接口提供的公众账号ID
随机字符串nonce_strstring(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS微信返回的随机字符串
签名signstring(64)C380BEC2BFD727A4B6845133519F3AD6微信返回的签名,详见签名算法
微信分账订单号order_idstring(64)4208450740201411110007820472原发起分账请求时,微信返回的微信分账单号,与商户分账单号一一对应。
商户分账单号out_order_nostring(64)P20150806125346原发起分账请求时使用的商户系统内部的分账单号。
商户回退单号out_return_nostring(64)R20150806125346调用接口提供的商户系统内部的回退单号
微信回退单号return_nostring(64)3008450740201411110007820472微信分账回退单号,微信系统返回的唯一标识
回退方类型return_account_typestring(32)MERCHANT_ID枚举值:
MERCHANT_ID:商户ID
回退方账号return_accountstring(64)86693852回退方类型是MERCHANT_ID时,商户ID
回退金额return_amountint888回退金额,整数,单位为分
回退描述descriptionstring(80)用户退款分账回退的原因描述
回退结果resultstring(32)SUCCESS枚举值:
PROCESSING:处理中
SUCCESS:已成功
FAILED: 已失败如果查询到回退结果在处理中,请勿变更商户回退单号,使用相同的参数再次发起分账回退,否则会出现资金风险。
在处理中状态的回退单如果5天没有成功,会因为超时被设置为已失败。
失败原因fail_reasonstring(32)ACCOUNT_ABNORMAL枚举值:
ACCOUNT_ABNORMAL:分账接收方账户异常
TIME_OUT_CLOSED: 超时关单
此字段仅回退结果为FAILED时存在
完成时间finish_timestring(16)20180608170132分账回退完成时间

错误码

名称描述原因解决方案
SYSTEMERROR接口返回错误系统超时请尝试再次调用API
PARAM_ERROR参数错误请求参数未按指引进行填写请求参数错误,请重新检查再调用分账完结接口
INVALID_REQUEST请求不合法参数中APPID或 MCHID不存在等请检查请求参数
FREQUENCY_LIMITED频率限制请求过多被频率限制该笔请求未受理,请降低频率后原单重试,请勿更换商户分账单号
ORDERNOTEXIST回退单不存在分账单号或者回退单号错误请检查分账单号,回退单号是否有误