捷安数据接口对接文档v8.pdfVIP

捷安数据接口对接文档 V1.5.8 更新时间：2016.11.05 第 1 页 目 录 1 目的 1 2 接口规范 1 2.1 数据协议总则 1 2.2 数据交换格式 1 2.2.1 请求数据格式 1 2.2.2 响应格式2 2.3 jsonStr 数据域详解2 2.3.1 请求 Json 域 2 2.3.2 返回 Json 域 2 2.4 数据安全3 3 样例3 3.1 请求数据3 3.2 返回数据4 4 返回码（respCode ）4 1 目的 本文档的目的是定义平台与企业网站之间的通讯约定、以及接口规范，以方便双方 相关人员进行业务沟通与交流之用。同时也作为平台与企业等各方业务功能开发的基础 参考性文档。 2 接口规范 2.1 数据协议总则  通讯协议：平台向外开放的通讯协议采用 http 协议。  编码：默认使用 utf-8 ，否则中文字符可能为乱码并且chkValue 校验不过  接口地址：/vpre/ccmn/verify  对接工具地址：/vpre  正式环境每个接入方需要登记访问 IP ，只对授权的 IP 地址开通访问权限。 测试环境不需要。 2.2 数据交换格式 2.2.1 请求数据格式 商户向平台方的数据请求为 FROM 表单，提交方式为 POST 方式，INPUT 数据项如下 数据项标识 长度 是否必须 备注 versionId 定长2 位 是 01 chrSet 变长8 位 是 UTF-8 custId 变长12 位 是 客户号，由平台分配给商户的唯一标识 ordId 变长30 位 是 订单号，由商户系统产生的交易请求唯一标识码，不 能含有中午字符 组成规则：商户拼音简写+YYYYMMDD+流水号 transType 变长12 位 是 REPORT busiType 变长8 位 否 业务类型，可以为空，由商户自己定义，用于区分订 单类型 第 1 页 merPriv 变长120 位 否 商户私有域，可以为空，由商户自己定义，平台原样 返回 retUrl 变长160 位 否 返回URL 地址，可以为空，如果不为空，平台将交易 响应异步通过该地址返回 jsonStr 变长999 位 是 Json 字符串，包含和交易相关的请求数据，为json 格 式，详情参考2.3 jsonStr 数据域详解 macStr 定长32 位 是 签名串，组成规则参见 2.4 数据安全 2.2.2 响应数据格式 平台方响应的数据报文为XML 格式 ，同步返回，数据项