商户付款订单查询(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为终态,其他状态需继续查询直至终态