对接必读

灵活用工人员签约

商户付款

商户付款订单查询(settle.remit.api.query）

简要描述

商户调用此接口可查询订单状态，若调用出现网络问题或9999，请求多次调用确定状态。

请求参数

参数名 类型 是否必填 最大长度 参数含义 参数说明
custBatchNo String 是 32 商户批次号 自定义批次号

响应参数

参数名 类型 是否必填 最大长度 参数含义 参数说明
custBatchNo String 是 32 商户批次号 同请求
platBatchNo String 是 64 云享平台批次号 同请求
recvType String 是 19 付款类型，银行卡(BANK)；支付宝(ALIPAY)；微信钱包(WECHATPAY) 同请求
batchAmt BigDecimal 是 16 批次付款金额 单位元保留两位小数
batchServFeeAmt BigDecimal 是 16 服务费金额 单位元保留两位小数
totalDeduction BigDecimal 是 32 总扣款金额 付款金额+服务费
batchStatus int 是 64 批次状态 0-初始
code String 是 32 返回码,请参考返回码列表 见错误码表
message String 是 32 返回码的详细说明 见错误码表
remitDetailList Array 是 - 订单明细 每笔订单明细

明细参数

参数名 类型 是否必填 最大长度 参数含义 参数说明
custOrderNo String 是 32 商户订单号 自定义订单号需唯一
recvCustName String 是 32 收款者姓名
recvMobile String 是 11 收款者手机号
recvIdType String 是 32 收款者证件类型 IDENTITY（居民身份证）
recvIdNo String 是 18 收款者证件号
recvCardNo String 是 20 收款者银行卡号
recvBankName String 是 18 收款银行 不校验可传简称
remark String 是 128 付款备注 根据个人收款行不同，显示的内容略有差别
orderAmt BigDecimal 是 18,2 付款金额 个人实际收到金额
orderStatus Int 是 - 明细付款手续费 见下方订单状态说明
servFeeAmt BigDecimal 是 18,2 明细付款手续费
orderTotalAmt BigDecimal 是 18,2 此笔明细扣费总和 付款金额+服务费
errorMsg String 否 64 失败原因 订单失败时返回
batchFinishDate String 是 19 批次完成时间 格式格式为yyyy-MM-dd HH:mm:ss 2022-03-20 10:22:47；
platOrderNo String 是 64 平台订单号

错误码

错误码 错误码描述 错误码具体描述
0000 成功 仅代表查询成功
0001 参数为空或格式错误 仅代表查询失败，非付款订单失败，需要确认调用参数是否合法，或联系我方技术支持进行处理
9999 系统异常 仅代表查询异常，非付款订单失败，需要确认调用参数是否合法，或联系我方技术支持进行处理
0005 批次信息不存在 未找到批次信息，可以稍后再次查询；如尝试重发， 请务必使用原单号发起请求

订单状态：

批次状态 描述
0 初始状态，需继续查询
1 成功
2 失败
7 部分失败
10 订单超时
其他状态 处理中，需要查询到1，2，7，10 等终态
明细状态 描述
0 初始状态，需继续查询
1 成功
2 失败
10 订单超时(可按失败处理)
其他状态 处理中，需要查询到1，2，10 等终态

注：若返回9999，建议查询订单状态后再发起请求，或者原订单请求，避免重复出款。批次状态 1，2，7，10为终态，其他状态需继续查询直至终态