产品平台报文接口规范
1总体技术方案
1.1通讯方式
所有报文域以JSON报文格式,发送到汇宜产品平台。
前端发送交易结果同步响应给商户,如超时仍未得到交易响应,商户可通过发起交易查询获取交易处理结果。
交易状态查询类交易,交易结果同步响应给商户。
1.2符号约定
表1符号约定
符号 | 含义 | |
数据兀数值符号 | M | 必须填写的域 |
C | 某条件成立时必须填写的域 | |
O | 受理方和发卡方自选填写的域 | |
R | 必须与先前报文中对应域的值相冋的域 | |
1.3签名机制
1.3.1.1报文的签名机制
对于报文的签名处理机制如下:
首先,对报文中msg_body对象域转换成json字符串,再使用机构RSA私钥证书对该串做签名操作(签名时算法选择SHA-1)。最后,对签名做Base64编码,将编码后的签名串放在签名(signature)字段中,将报文放在body中,以json方式发送给汇宜产品平台。
1.3.1.2报文的验签机制
对于报文的验签处理机制如下:
首先,取出msg_body域值作为待签名串。
其次,使用汇宜机构RSA公钥证书对待签名串和报文中的签名信息做签名验证操作。
报文示例:
「〃・〃〃rf\八〃〃i・〃〃ttflc〃〃
{"version":"1.0.0","encoding":"UTF-8","signature":"x/nSIrz/lJnVH4Nv+zOB/nGrkJ0r0nDZIMis1UqIxVG/xNMHYN7dqpj/qBl1uFt8O0ko813SC8e8Lnc7W1K/AR01IEn8Lzq1WYnx0qmDIwSrrsQMuRo1D0agOuNlPaL3weKKBAGdUdsahASPURKZ1sXsLP/43r+3ufPvZitnL575xPLKQaZO7xq6ien7ZW4tb0VGKcj06IQ9AA5zOFANTweIPao+7ttqKysOEF2PY/y0NSN/hFQ0P7Me7XobNXzyZW/kMir/Sa447xwnAs2tkrDQm4h4icNEASFZZltXp1Xwk24obwl4Uc11PnTG2IxvQwZmyeP4sRJe24y6FWjgwA==","sign_method":"01","msg_body":"{\"ins_id_cd\":\"\",\"prod_cd\":\"1151\",\"biz_cd\":\"\",\"mcht_cd\":\"9969\",\"tran_dt_tm\":\"201\",\"order_id\":\"\",\"tran_amt\":\"1\",\"qr_code_info\":{\"noti_url\":\"8.30.10:8088/prodpmpnotify\"},\"tran_cd\":\"7131\"}"}
异步通知正常应答报文样例:
{"version
":"1.0.0","encoding":"UTF-8","sign_method":"01","msg_body":"{\"ins_id_cd\":\"\",\"sys_order_id\":\"2089\",\"t
ran_cd\":\"6132\",\"resp_cd\":\"00\",\"resp_msg\":\"成功\"}"}
1.3.2加密方式
1.3.2.1交易PIN
对于持卡人密码汇宜产品平台使用RSA公钥证书对ANSIX9.8带主帐号格式的PIN加密并做Base64编码后传输,以保障密码的安全性。依据商户可选配置,对于CVN2、有效期、卡号使用RSA公钥证书分别做加密并Base64处理。
交易时间字符串是什么1.3.2.2敏感信息
对于敏感信息银行卡验证信息及身份信息部分内容,采用Base64编码后传输,以做数据屏蔽。
1.4数据元长度的计算数据元长度的计算说明:所有长度均按字节计算,中文算两个字节,英文、数字算一个字节。
1.5URL的编码
URL参数中中文等特殊字符需编码。
1.6数据元类型定义
Ax | x字节定长的字母字符 |
Ax..y | 长度为X-y字节的变长字母字符 |
ANx | x字节定长的字母和/或数字字符 |
长度为x-y字节的变长字母和/或数字字符 | |
ANSx | x字节定长的字母、数字和/或特殊符号字符 |
长度为x-y字节的变长字母、数字和/或特殊符号字符 | |
ASx | x字节定长的字母和/或特殊符号字符 |
长度为xy字节的变长字母和/或特殊符号字符 | |
Nx | x字节定长的整型数值,若表示金额,则以分为单位 |
Nx..y | 长度为x-y字节的整型数值,右表示金额,则以分为单位 |
NSx | x字节定长的数字符和/或特殊字符 |
长度为x-y字节的数字字符和/或特殊字符 | |
Sx | x字节定长的特殊符号字符 |
Sx..y | 长度为x-y字节的变长特殊符号字符 |
ss | 秒 |
DD | 日 |
hh | 时 |
MM | 月 |
mm | 分 |
YY | 年(2字节) |
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论