服务商电子回单生成

功能概述

服务商通过此接口获取境内收单电子回单

注:该接口生成回单将保留7个自然日,请及时下载。

接口地址

https://apis.5upay.com/onlinePay/generateVoucherPartner

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
partnerId 服务商id varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 C
requestId 电子回单生成订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一 M
orderId 收单原订单号 varchar(50) 商户原统一收单交易订单号 M
usersSign 支付用户标识 varchar(50) 填1表示需要生成,为空即为不需要生成 O
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

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

参数示例

{ "partnerId": "890000593", "merchantId": "897300798", "requestId": "gv1774862135213", "orderId": "173623577003131" }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商Id 同请求参数
requestId 订单号 同请求参数
orderId 收单原订单号 同请求参数
status 状态 SUCCESS 成功,电子回单生成成功
FAILED 失败,电子回单生成失败或原订单无结果
ERROR 错误
downloadUrl 回单地址 收单回单地址,需要连接ftp获取对应的回单图片
服务商路径:/report/partner/online_pay/onlinepayvoucher/yyyyMMdd/[partnerId]境内收单交易回单-收单原订单号.pdf
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "downloadUrl": "/report/partner/online_pay/onlinepayvoucher/20260511/897300798境内收单交易回单-173623577003131.pdf", "merchantId": "897300798", "orderId": "173623577003131", "partnerId": "890000593", "requestId": "gv1774862135213", "status": "SUCCESS" }