补贴订单查询接口

功能概述

商户可以通过此接口查询一笔统一收单的全部补贴明细,以及每笔补贴明细的已退补贴金额

接口地址

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

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

注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格

参数示例

{ "merchantId": "89***93", "requestId": "152***8867", "hmac": ******* }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
partnerId 服务商Id 同请求参数
status 状态 SUCCESS 接口调用成功
ERROR 接口调用失败
status 状态 收单订单的状态
INIT 初始化
SUCCESS 成功
CANCEL 取消
FAILED 失败
subsidyDetail 补贴明细 查询成功时返回,数组形式,该笔收单对应的全部补贴订单信息
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

subsidyDetail 补贴明细

参数名称 参数中文名称 参数说明
subsidyDetailId 补贴订单号 首信易生成的补贴订单的唯一标识
subsidyMerchantId 补贴方商户编号 该笔补贴明细的商户编号
subsidyDetailAmount 补贴金额 该笔补贴明细的补贴金额
subsidyStatus 补贴状态 该笔补贴明细的状态
INIT 初始化
SUCCESS 成功
CANCEL 取消
FAILED 失败
refundedSubsidyAmount 已退款补贴金额 该笔补贴明细已成功退回和处理中的退款补贴金额

参数示例

{ "subsidyDetail": [ { "subsidyMerchantId": "896671192", "subsidyDetailAmount": "300", "refundedSubsidyAmount": "0", "subsidyDetailId": "20241022467345033436016637165568", "subsidyStatus": "SUCCESS" } ], "merchantId": "896671027", "requestId": "1729562357851", "hmac": "3046022100aad20a09d4d8dd72c", "orderStatus": "SUCCESS", "partnerId": "", "status": "SUCCESS" }