资源预览内容
第1页 / 共14页
第2页 / 共14页
第3页 / 共14页
第4页 / 共14页
第5页 / 共14页
第6页 / 共14页
第7页 / 共14页
第8页 / 共14页
第9页 / 共14页
第10页 / 共14页
亲,该文档总共14页,到这儿已超出免费预览范围,如果喜欢就下载吧!
资源描述
翼支付网关电信账单支付技术接口规X(Android版V1.2)修订历史记录修改时间版本号修改内容修改人V1.0初稿王静V1.1新增校验地址、后台通知地址说明王静2015.0515V1.2上行短信后同步返回受理成功王静1. 文档说明31.1 文档目标31.2 阅读对象31.3 相关约定31.4 业务与技术支持32. 业务描述32.1 功能说明与流程(三种支付方式)33. 翼支付客户端接口53.1账单支付功能接口53.2接口配置信息63.3支付结果后台通知机制74. 开发提示71. 文档说明1.1 文档目标本文档的目的是为电信账单支付业务定义一个标准接口规X,以帮助各省电信与合作商户技术人员接入翼支付网关电信账单支付业务,并快速掌握翼支付网关电信账单支付的相关功能,为业务开展提供支付服务。1.2 阅读对象对翼支付网关平台电信账单支付存在需求的公司、机构与合作商户的网上应用开发人员、维护人员和业务管理人员。1.3 相关约定商户:指已注册成为翼支付网关用户、并使用翼支付网关产品实现其收付费功能需求、为其用户提供各类产品或者相关服务的个人。用户:指在商户等系统购物的个人。购物:指用户在商户购买相关产品或服务。1.4 业务与技术支持如果您有任何业务与技术上的疑问,可联系天翼电子商务XX(以下简称支付公司)技术人员。2. 业务描述2.1 功能说明与流程(三种支付方式)用户通过话费完成电信账单支付的能力,目前只支持电信手机。三种支付方式短信直接支付,短信验证码支付,二次确认支付只能使用一种,支付公司会根据合作商户的具体情况提供不同支付方式。直接支付:短信验证码支付:二次确认支付:3. 翼支付客户端接口3.1账单支付功能接口1. Android SDK包描述名称描述BestpaySDK.jar为商户提供订单支付功能接口的开发包。2. 接口参数信息MERCHANTIDN商户号;商户惟一标识;如:;17KEYN商户Key;如:344C4FB521F5A52EA28FB7FC79AEA889478D4343E4548C02不限ORDERAMOUNTN订单金额;单位(分);4PAYTYPEN支付方式;参数约定:1直接支付, 2验证码支付, 3二次确认支付;1GOODSCODEN商品编码;6GOODSNUMN商品数量;3GAMENAMEN游戏名称;不限ATTACHY备注信息;153.2接口配置信息1. 商品校验地址配置如果商户需商品校验功能,则商户需提供“商品校验地址”供翼支付运营人员进行配置。如果商户未配置校验地址,则不进行校验。翼支付交易引擎通过协议,通过post方式向商户提供校验地址发起校验请求。校验要素:goodsCode商品编码+orderAmount订单金额-单位:分+attach产品描述+phoneNum扣款账号+orderNo订单号返回参数:true或者false2. 后台通知地址配置后台通知地址用于将支付结果反馈通知给商户侧;商户需提供“后台通知地址”供翼支付运营人员进行配置。商户配置了支付结果通知地址后,支付结果通知以配置的地址为准。通知接口定义:ORDERSEQ订单号an30是商户提交的订单号ORDERREQTRANSEQ订单请求支付流水号an30是商户订单请求流水号,该流水在商户处必须是唯一的,而且每次发起支付时,都必须是唯一的UPTRANSEQ支付平台交易流水号an30是由支付平台提供,商户必须保存该信息,作为对帐依据TRANDATE支付平台交易日期n8是由支付平台提供,商户必须保存该信息,格式:yyyyMMDD, 商户对账、清算报表以此日期为准ORDERAMOUNT订单交易金额n10是单位:元RETNCODE交易状态an10是0000表示成功,其余表示失败(0000:表示成功, 9999:表示系统异常,未知错误,其他错误码:验证错误、支付失败描述)RETNINFO交易结果描述An256是交易结果描述MERCHANTID商户号n30是由翼支付网关平台统一分配SIGNMac校验域ans32是md5摘要通知接口相应:ans20MUPTRANSEQ_upTranSeq:表示通知upTranSeq为真实值UPTRANSEQ_其它:表示失败通知接口说明:1. 商户要对mac校验域进行校验。2. key由翼支付网关支付平台分配给各商户。3. MAC校验,保证了交易信息到支付平台的完整性,参与MAC运算的字符与其顺序如下:UPTRANSEQ=XX&MERCHANTID=XX&ORDERSEQ=XX&ORDERAMOUNT=XX&RETNCODE=XX&RETNINFO=XX&TRANDATE=XX&KEY=XX翼支付网关支付平台将上述固定顺序组织的字符串,参数名均为大写,使用标准md5算法进行摘要,然后将摘要果转成16进制字符串,就是校验域MAC的值,将MAC值和支付结果通知信息在调用接口时,一起提供给商户平台,由商户使用标准md5算法算出mac值,和翼支付网关支付平台提供的mac值进行比对,如果一致,说明该通知是由翼支付网关支付平台提供,否则,则是虚假信息。3.3支付结果后台通知机制1.翼支付网关平台交易处理完成后,立即向商户发起通知。如果在60秒钟没有收到应答,则会重复发送,重复次数是3次(中间时间间隔,3分钟、5分钟、8分钟)。如果还没有应答会每隔半小时发送一次截止到第二天凌晨。2.翼支付网关平台如果收到商户应答,则不再发送支付结果。3.接口参数不正确导致订单校验失败的通知只发送一次。4.商户侧若未收到支付结果,可先提示用户“支付结果查询超时,如有疑问请联系客服!”。4. 开发提示1)在清单文件AndroidManifest.xml中添加以下权限注:如需适配Android 6.0系统,请在调用接口之前做好权限的申请 2) 将res下的资源文件、so库等拷到需要集成工程的相应目录下具体可参考demo3) 在activity中添加以下代码BestPay.getInstance().pay(MainActivity.this, params, new PayCallback() Overridepublic void paySuccess(Mapparams) 成功支付回调params为支付时传递的参数Overridepublic void payFailed(Mapparams, interrorcode,String errorMsg) 失败回调params为支付时传递的参数errorMsg是对失败原因的简单描述Overridepublic void payCancel(Mapparams) 用户取消支付回调params为支付时传递的参数); 1) 错误码说明:错误码描述100Activity为空101商品信息错误102支付回调为空104支付参数出错(如:必传参数为空或参数长度过长)105SIM不支持电信106支付类型错误107支付超时108短信发送失败109频繁交易
网站客服QQ:2055934822
金锄头文库版权所有
经营许可证:蜀ICP备13022795号 | 川公网安备 51140202000112号