小通分期商户接入手册_1.4.docxVIP

小通分期商户接入手册通联商务2016年8月版本号日期维护人说明V1.02016/8/24张调初稿V1.12016/9/5张调添加关键数据域加密V1.22016/11/02张调产品修改，增加附属信息字段V1.32016/12/04张调去掉部分接口V1.42017/5/24袁豪优化部分字段说明文档说明文档概述 分期业务的发展极大的拓宽了商户及消费者的购物消费范围，通联商务为消费者提供合适的分期消费支付途径。文档范围本文档描述了通联商务合作商户如何接入通联商务在线支分期付系统，拓展商户支付合作渠道。阅读对象需要接入通联商务的合作商户及相关技术人员。增加商户需要或请求接入在线支付系统的商户首先必须成为通联商务合作商户。新商户的接入请参考合作商户增加相关规定。商户准入开通权限：已成为合作伙伴的商户需要有通联商务服务人员为商户开通在线支付功能权限签发密钥证书：为商户签发数据传输过程中所需密钥证书数据请求在线支付接口数据传输使用HTTP(或HTTPS)协议，商户提交的数据使用POST的方式提交到通联商务支付网关。HTTP请求POST方式/*post向服务器请求数据*/HttpPost request = newHttpPost(url);StringEntity se = newStringEntity(JsonUtil.toJson(map), UTF-8);se.setContentType(application/json);request.setEntity(se);HttpResponse response = newDefaultHttpClient().execute(request);/*TODO 获取响应报文*/说明：请求的数据格式为jsonurl：请求地址map：请求参数集合，包括系统级参数和业务级参数。关键信息加密根据通联商务提供的DES加密密钥，对需要传递关键信息进行加密，加密后用BASE64算法编码作为传输的值。算法：RESULT = BASE64(DES(SOURCE,DESKEY))DES加密源码示例（以Java为例），入下：异常错误简介通联商户开放平台的接口的定义了标准的异常处理机制，所有请求除交易成功的报文，返回的其他都是异常错误报文；合作伙伴获取错误报文内的编码进行业务处理错误报文分类接入层面分成两级：开放平台错误和业务系统错误。错误报文示例{ error_response: { sub_msg: 缺少必要的参数:产品编号, args: { arg: [ { value: 4A907CB2AD13EA7B1EAD8B41E325C05D, key: sign }, { value: 20150727173841, key: timestamp }, { value: 1, key: v }, { value: 9515600010000000110,9515600010000000011, key: card_ids }, { value: acctapi, key: app_key }, { value: allinpay.ppcs.cardinfobatch.get, key: method }, { value: 1, key: sign_v }, { value: json, key: format } ] }, res_timestamp: 20150727173845, code: 50, sub_code: missing-parameter:product_id, msg: 缺少必选参数, res_sign: 2A4E709451857FC7C3680CD9A58A6721 }}错误报文处理方式合作伙伴根据返回的错误，如果有code、msg、sub_code、sub_msg不为空，则进行错误流程处理开放平台错误平台级错误参数，主要是验证参数的是否为空，合法性，以及接入安全的校验等；50以内的为接入平台的错误，50以上的为业务平台的父级错误。接入平台错误只返回code和msg，不返回sub_code和sub_msg错误码 错误描英文 错误中文 解决方案 9Http Action Not AllowedHTTP方法被禁止请用大写的POST或GET，如果有图片等信息传入则一定要用POST才可以10Service Currently Unavailable服务不可用接口暂停或不能使用11Insufficient ISV Permissions合作伙伴权限不足应用没有权限调用该接口的权限12Remote Service Error远程服务出错API调用后端服务出错 21Missing Method缺少方法名参数传入的参数加入method字段22Invalid Method不存在的方法名传入的meth