服务商通过此接口获取境内收单电子回单
注:该接口生成回单将保留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 |
注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| partnerId | 服务商Id | 同请求参数 |
| requestId | 订单号 | 同请求参数 |
| orderId | 收单原订单号 | 同请求参数 |
| status | 状态 | SUCCESS 成功,电子回单生成成功 |
| FAILED 失败,电子回单生成失败或原订单无结果 | ||
| ERROR 错误 | ||
| downloadUrl | 回单地址 | 收单回单地址,需要连接ftp获取对应的回单图片 |
| 服务商路径:/report/partner/online_pay/onlinepayvoucher/yyyyMMdd/[partnerId]境内收单交易回单-收单原订单号.pdf | ||
| hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |