公共报文头

请求时需要确认好请求地址正确以及相关加密流程准确无误,请求方式为post,请求时请确认好编码为utf-8

键名 键值 注释
merchantId 商户编号 首信易分配给商户的唯一身份标识,在商户后台获取
requestId 商户订单号 商户自行拟定的订单号(如果业务没有订单号的话可不传此参数
partnerId 服务商id 首信易分配给服务商的唯一身份标识,和商户编号有对应关系(如果业务没有服务商id的话可不传此参数
Content-Type application/vnd.5upay-v3.0+json 首信易固定的请求头 (国际算法返回)
application/vnd.5upay-v4.0+json 首信易固定的请求头 (国密算法返回)
encryptKey 经过公钥加密过后的密钥数据 请求加密流程里的公钥加密后得到的值

参数示例

{ "merchantId": "890000593", "requestId": "1556592332569", "ContentType" = "application/vnd.5upay-v3.0+json", "partnerId"="890000595", "encryptKey"="OsYlS3vP1I+m5csUDTSbi801evXvMDsMejLHtqIqbtA5QTdPTjvCE2q4NLFek53Sqo 0HxjcHxxgbX5QMEM7y0VMmeUmaLJ7BK/RR3Zc5xtHkWE/AbO8ErG7oXgORZ6JVakeRlDG8sSVTT2 Duvy38RsXUQC4Vj4VHgxsLq398vfYQZgf9O8FPfSc+m7g8MGhbbuqMSbOWBH1lDKnCkpl93XSiWF YHICt7aO/P9avhqlSVJDQg2KpwMld6Mfag5hgz/LTE7DfwyueH6VxIU7rrUkelWZSbO3ULUg7G5o kRAFvXJPqfTnkRnQ+qTsK3QOpb98XlaR+tjuYqzTWs+/mUVg==" }

异常情况说明

说明:所有接口异常情况会返回以下参数且异常情况不需要进行验签

参数名称 参数中文名称
merchantId 商户编号
code 错误编码
status ERROR
error 错误概述
cause 错误详情

参数示例

{ "cause": "{\"bankCardNumber\":{\"message\":\"bankcardnum.invalid\"}}", "code": "E1004016", "error": "方法参数无效", "merchantId": "890001312", "status": "ERROR" }