批量代付查询

功能概述

商户通过此接口查询代付明细数据状态

接口地址

https://apis.5upay.com/transferDomestic/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
partnerId 服务商id varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 C
requestId 订单号 varchar(50) 代付提交接口传入的requestid M
remitRequestId 明细订单号 varchar(50) 批量代付接口传入的remitRequestId M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

以上参数值中不能包含以下特殊字符’”&<>()

参数示例

{ "merchantId": "890000593", "partnerId": "", "requestId": "152***8976", "remitRequestId": "152***8976_1", "hmac": null }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
amount 代付金额 单位:分,1元=100分
completeDateTime 完成时间 代付完成时间
serialNumber 交易流水号 首信易系统交易流水号
errorMessage 错误信息 代付失败后会返回此参数告知商户代付失败原因
remark 备注 在下单请求中提交的备注信息,返回给商户
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
remitRequestId 明细订单号 同请求参数
currency 代付币种 默认人民币CNY
partnerId 服务商id 同请求参数
status 状态 SUCCESS 代付到账成功
FAILED 代付失败,商户可重新发起
CANCEL 代付取消,商户可重新发起
INIT 代付待处理,等待后再次查询,如果长时间保持此状态请联系首信易
REMITING 代付中,等待后再次查询,如果长时间保持此状态请联系首信易
ERROR (此状态的返回参数见异常情况说明)
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "amount": "1", "completeDateTime": "2024-09-27 19:43:18", "serialNumber": "7ecb1***f72ad7", "errorMessage": "BE000012|银行卡未开通或被限制相关支付权限,请咨询发卡行(账户状态为受限)", "remark": "", "merchantId": "890000593", "requestId": "172***996", "hmac": "eKSmZHw***Y0UX31LG7xuJuxnHPSMl2dgg==", "remitRequestId": "890****101", "currency": "CNY", "partnerId": "", "status": "FAILED" }