《翼支付网关电信账单支付技术接口规范(SDK版)V1.2》由会员分享，可在线阅读，更多相关《翼支付网关电信账单支付技术接口规范(SDK版)V1.2（14页珍藏版）》请在金锄头文库上搜索。
1、翼支付网关电信账单支付技术接口规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，以帮助各省电信与合作商户技术人员接入翼
2、支付网关电信账单支付业务，并快速掌握翼支付网关电信账单支付的相关功能，为业务开展提供支付服务。1.2 阅读对象对翼支付网关平台电信账单支付存在需求的公司、机构与合作商户的网上应用开发人员、维护人员和业务管理人员。1.3 相关约定商户：指已注册成为翼支付网关用户、并使用翼支付网关产品实现其收付费功能需求、为其用户提供各类产品或者相关服务的个人。用户：指在商户等系统购物的个人。购物：指用户在商户购买相关产品或服务。1.4 业务与技术支持如果您有任何业务与技术上的疑问，可联系天翼电子商务XX(以下简称支付公司)技术人员。2. 业务描述2.1 功能说明与流程（三种支付方式）用户通过话费完成电信账单支付
3、的能力，目前只支持电信手机。三种支付方式短信直接支付，短信验证码支付，二次确认支付只能使用一种，支付公司会根据合作商户的具体情况提供不同支付方式。直接支付:短信验证码支付:二次确认支付:3. 翼支付客户端接口3.1账单支付功能接口1. Android SDK包描述名称描述BestpaySDK.jar为商户提供订单支付功能接口的开发包。2. 接口参数信息MERCHANTIDN商户号；商户惟一标识；如：；17KEYN商户Key；如：344C4FB521F5A52EA28FB7FC79AEA889478D4343E4548C02不限ORDERAMOUNTN订单金额；单位(分)；4PAYTYPEN支付
4、方式；参数约定：1直接支付， 2验证码支付， 3二次确认支付；1GOODSCODEN商品编码；6GOODSNUMN商品数量；3GAMENAMEN游戏名称；不限ATTACHY备注信息；153.2接口配置信息1. 商品校验地址配置如果商户需商品校验功能，则商户需提供“商品校验地址”供翼支付运营人员进行配置。如果商户未配置校验地址，则不进行校验。翼支付交易引擎通过协议，通过post方式向商户提供校验地址发起校验请求。校验要素：goodsCode商品编码+orderAmount订单金额-单位：分+attach产品描述+phoneNum扣款账号+orderNo订单号返回参数：true或者false2.
5、后台通知地址配置后台通知地址用于将支付结果反馈通知给商户侧；商户需提供“后台通知地址”供翼支付运营人员进行配置。商户配置了支付结果通知地址后，支付结果通知以配置的地址为准。通知接口定义：ORDERSEQ订单号an30是商户提交的订单号ORDERREQTRANSEQ订单请求支付流水号an30是商户订单请求流水号，该流水在商户处必须是唯一的，而且每次发起支付时，都必须是唯一的UPTRANSEQ支付平台交易流水号an30是由支付平台提供，商户必须保存该信息，作为对帐依据TRANDATE支付平台交易日期n8是由支付平台提供，商户必须保存该信息，格式：yyyyMMDD, 商户对账、清算报表以此日期为准O
6、RDERAMOUNT订单交易金额n10是单位：元RETNCODE交易状态an10是0000表示成功，其余表示失败(0000:表示成功， 9999:表示系统异常，未知错误，其他错误码：验证错误、支付失败描述)RETNINFO交易结果描述An256是交易结果描述MERCHANTID商户号n30是由翼支付网关平台统一分配SIGNMac校验域ans32是md5摘要通知接口相应：ans20MUPTRANSEQ_upTranSeq:表示通知upTranSeq为真实值UPTRANSEQ_其它:表示失败通知接口说明：1. 商户要对mac校验域进行校验。2. key由翼支付网关支付平台分配给各商户。3. MAC
7、校验，保证了交易信息到支付平台的完整性，参与MAC运算的字符与其顺序如下：UPTRANSEQ=XX&MERCHANTID=XX&ORDERSEQ=XX&ORDERAMOUNT=XX&RETNCODE=XX&RETNINFO=XX&TRANDATE=XX&KEY=XX翼支付网关支付平台将上述固定顺序组织的字符串，参数名均为大写，使用标准md5算法进行摘要，然后将摘要果转成16进制字符串，就是校验域MAC的值，将MAC值和支付结果通知信息在调用接口时，一起提供给商户平台，由商户使用标准md5算法算出mac值，和翼支付网关支付平台提供的mac值进行比对，如果一致，说明该通知是由翼支付网关支付平台提供
8、，否则，则是虚假信息。3.3支付结果后台通知机制1.翼支付网关平台交易处理完成后，立即向商户发起通知。如果在60秒钟没有收到应答，则会重复发送，重复次数是3次(中间时间间隔，3分钟、5分钟、8分钟)。如果还没有应答会每隔半小时发送一次截止到第二天凌晨。2.翼支付网关平台如果收到商户应答，则不再发送支付结果。3.接口参数不正确导致订单校验失败的通知只发送一次。4.商户侧若未收到支付结果，可先提示用户“支付结果查询超时，如有疑问请联系客服！”。4. 开发提示1)在清单文件AndroidManifest.xml中添加以下权限注：如需适配Android 6.0系统，请在调用接口之前做好权限的申请 2)
9、 将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频繁交易
