商盟统统付支付网关商户开发指引.DOCVIP

统统付商户后端接入模式开发指南 版本号：1.3.2 商盟商务服务. 文档更新记录 版本 状态 描述 修订 日期 作者 v1.0 A 文档初建 2014-3-20 陈灵龙 v1.1 A 交易字段更新 2014-4-02 沈嘉平v1.2 M 修改2014-4-02 冯常军v1.3 M 字段修改 2014-4-26 沈嘉平 目录 1 引言 4 1.1 概述 4 1.2 名词缩写及定义 4 2 开发规范 5 2.1 通信方式 5 2.2 接口说明 5 3 商户接口 6 3.1 获取手机动态码接口 7 3.1.1 功能描述 7 3.1.2 提交参数定义 7 3.1.3 返回参数定义 9 3.2 快捷支付接口 10 3.2.1 功能描述 10 3.2.2 提交参数定义 10 3.2.3 返回参数定义 12 3.3 快捷注销接口 13 3.3.1 功能描述 13 3.3.2 提交参数定义 13 3.3.3 返回参数定义 14 3.4 支付订单查询接口 14 3.4.1 功能描述 14 3.4.2 提交参数定义 14 3.4.3 返回参数定义 15 3.5 支付通知接口 16 3.5.1 功能描述 16 3.5.2 提交参数定义 16 3.5.3 返回参数定义 17 3.6 退款接口 17 3.6.1 功能描述 17 3.6.2 提交参数定义 18 3.6.3 返回参数定义 18 3.7 退款订单查询接口 19 3.7.1 功能描述 19 3.7.2 提交参数定义 19 3.7.3 返回参数定义 20 3.8 退款通知接口 21 3.8.1 功能描述 21 3.8.2 提交参数定义 21 3.8.3 返回参数定义 22 3.9 对账接口 22 3.9.1 功能描述 22 3.9.2 提交参数定义 22 3.9.3 对账文件定义 23 4 附录 25 4.1 银行参数表 25 4.2 签名机制 25 4.2.1 需要参与签名的参数 25 4.2.2 生成待签名字符串 26 4.3 RSA签名 26 4.4 业务返回码定义 27 4.5 扩展信息说明 27 4.5.1 终端详情说明 27 引言 概述 此文档专为商盟支付平台的合作商户提供。目的是帮助商户的技术人员开发相关的接入程序。请相关技术人员详细阅读本手册。 名词缩写及定义 名词缩写 定义 订单号 本文所述的“订单号”为商户系统生成的订单号。（唯一性） 商户代码 商户在商盟支付平台注册的商户编码（唯一性）。 开发 通信方式 双方采用HTTP/HTTPS协议进行通信，双方均为服务器。如下图所示： 支付请求、订单查询，是HTTPS协议请求，商户以POST方式发送到商盟支付平台。 参数名称和参数说明中规定的固定值必须与列表中完全一致（大小写敏感）。 目前商户接口支持签名方：RSA的签名。 RSA签名使用的加密串可以在商户系统中进行维护。 接口说明 商户以POST方式请求服务端，服务端以JSON消息返回给客户端 接口说明 接口协议： HTTPS POST + JSON 接口地址： https://ip:port/xxxxxxx/api.htm 系统级输入参数： String 是 API版本号,默认1.0 service String 是 接口名称, 详见具体的务定义format String 是 响应格式。默认JSON app_id String 是 由平台统一分配合作商户唯一标识 timestamp String 是 格式如下：YYYYMMDDHHMMSS 例：2010202120000 terminal_type String 是 终端类型：web：PC方式;wap：手机WAP; mobile：手机客户端应用方式terminal_info String 否终端详情等信息）JSON格式; 例：{ip:’’} String 是 支持RSA和CERT必须大写,默认值:RSA API接入方式使用CERT sign String 是 API请求签名 返回参数： 字段名 类型 是否必输 说明 resp_code String 是 请求操作相应码。操作成功返回000000，操作失败响应码见通用响应码说明 resp_msg String 是 当resp_code不为000000时，该参数不能为空，返回操作失败原因 sign_type String 是 支持RSA和CERT必须大写,默认值:RSA API接入方式使用CERT sign String 是 响应数据签名 通用回说明： 说明 000000 操作成功 100000 操作失败 PS: 业务相关的回说明第.4 章节； version 是 MAX(10) API版本号,默认1.0 接口名