翼支付网关平台-手机WAP支付商户接口技术规范.docVIP

【手机WAP支付技术接口规范】 V1.0 2009年9月 中国电信天翼电子商务有限公司1. 文档说明 3 1.1 文档目标 3 1.2 阅读对象 3 1.3 相关约定 3 1.4 业务及技术支持 3 2. 业务描述及接口开发 3 2.1 功能说明及流程 3 2.2 商户接入前提 4 2.3 参数说明 5 2.3.1 HTTP订单支付请求接口 5 2.3.2退款接口 5 2.4 开发提示 5 2.4.1 商户对支付结果的处理 5 3. 参考资料 5 3.1 出参类型说明 5 1. 文档说明 1.1 文档目标 本文档的目的是为手机wap支付定义一个标准接口规范，以帮助商户支付，快速掌握功能，。 支付商户的手机wap应用开发人员、维护人员和管理人员。 2.2 商户接入前提 商户接入BestPay 手机wap支付，须准备好指定网站供客户上网浏览，并为用户提供商品查询、选购，直至下单的功能及页面展示。以下页面须由商户预先实现方能进行翼支付网关手机wap支付接入。 2.3 参数说明 2.3.1 HTTP订单支付请求接口 http订单支付请求地址：/payWap.do 接口描述 接口名称 重定向跳转订单支付请求接口 接口描述 通过调用支付接口向支付平台发出支付请求,平台通过支付Portal与用户进行交互，完成支付处理后，重定向回应用系统（SP） 接口提供者 支付平台 接口使用者 应用系统（SP） 接口定义 字段 名称 长度 是否必填 说明 MERCHANTID SP身份标识 CHAR(20) 是 由支付平台统一分配 SUBMERCHANTID SP下的子SP身份标识 CHAR(30) 否 由SP平台自己分配，在做支付时，可以一并发送过来，统一支付平台可以负责记录，如没有可以不填写 ORDERSEQ 订单号 CHAR(30) 是 由SP提供，在sp处不能重复，用于标识一个唯一的订单，订单号可以在没有支付成功的情况下，再次进行交易，但每次交易时的订单请求交易流水号不能重复 数字或字母组成 ORDERREQTRANSEQ 订单请求交易流水号 CHAR(30) 是 订单支付请求的交易流水号 每次订单支付时，不要重复 最好以日期时间（YYYYMMDDHHMMSS格式）加一固定长度（不小于4位）流水号组成，如： 20061012132425 + 0001 20061012132425 + 00001 数字或字母组成 ORDERDATE 订单日期 CHAR(8) 是 由SP提供，长度8 YYYYMMDD格式 ORDERAMOUNT 订单总金额 NUMBER(10) 是 单位：元，例如2.00 订单总金额 = 产品金额+附加金额 PRODUCTAMOUNT 产品金额 NUMBER(10) 是 单位：元 ATTACHAMOUNT 附加金额 NUMBER(10) 是 单位：元 CURTYPE 币种 CHAR(10) 是 默认填 RMB ENCODETYPE 加密方式 CHAR(1) 是 0：不加密 1：MD5摘要 默认 MERCHANTURL 前台返回地址 CHAR(128) 是 SP提供的用于接收交易返回的前台url，不做业务处理，仅仅用于前台页面显示结果 BACKMERCHANTURL 后台返回地址 CHAR(128) 是 SP提供的用于接收交易返回的后台url，用于实际的业务处理 ATTACH 附加信息 CHAR(128) 否 SP附加信息 BUSICODE 业务类型代码 CHAR(4) 是 默认填0001 TMNUM 终端号码 CHAR(40) 否 终端号码,如果涉及终端，则需要提供终端号码 CUSTOMERID 客户标识 CHAR(32) 否 PRODUCTID 产品标识 CHAR(10) 否 PRODUCTDESC 产品描述 CHAR(64) 否 MAC MAC校验域 CHAR(64) 是 默认为0，当加密方式为1时有意义，采用标准的MD5算法，由SP实现 说明： 1）商户要保证订单号的唯一性。 2）在商户提交订单的页面上，提交按钮应该是点击一次后，马上不可用，防止用户多次提交。 3） 接口方式采用表单方式，商户将以上信息包含在表单中，直接SUBMIT 到翼支付网关支付平台url上 4）MAC校验，保证了交易信息到支付平台的完整性，参与MAC运算的字符及其顺序如下： MERCHANTID=123456789ORDERSEQ=20060314000001ORDERDATERDERAMOUNT=10000.00KEY=G7AXS7874305BV59 将上述固定顺序组织的字符串，参数名均为大写，使用标准md5算法(32位长度，大写)进行摘要，然后将摘要果转成16进制字符