1.易支付网关电信账单支付技术接口规范（V1.2版本）修订历史记录修改时间版本号修改内容修饰符2014.11.18V1.0初稿王静2015.04.14V1.1新增验证地址及后台通知地址说明王Jing 2015..2 上行短信返回后，受理成功 王靖 1.文档说明 31.1 文档目标 31.2 阅读对象 31.3 相关协议 31.4 业务和技术支持 32. 业务描述 32.1 功能描述及流程（三种支付方式） 33. Wing 客户端接口 53.1 账单支付功能接口 53.2 接口配置信息 63.3 支付结果后台通知机制 74. 开发技巧 71. 文档说明 1.1 文档目的 本文档的目的是定义电信账单支付业务的标准接口规范

2、帮助各省电信及合作商户技术人员接入易支付网关电信缴费业务，快速掌握易支付网关电信缴费相关功能，为业务开展提供支付服务。 1.2阅读对象：有在易支付网关平台上进行电信话费支付需求的公司、机构、合作商户的在线应用开发者、维护者及业务管理者。 1.3 相关约定商户：是指注册成为易支付网关用户并使用易支付网关产品实现其收付功能需求并向其用户提供各类产品或相关服务的个人。 用户：指在商家网站等系统上购物的个人。 购物：是指用户在商家网站上购买相关产品或服务。 1.4 业务和技术支持 如果您有任何业务或技术问题，可以联系天翼电子商务有限公司（以下简称支付公司）的技术人员。 2. 业务描述 2.1 函数论

3、讲解用户通过话费支付电信话费的流程（三种支付方式）。 目前仅支持电信手机。 短信直接支付、短信验证码支付、二次确认支付三种支付方式只能选择其中一种。 支付公司将根据合作商户的具体情况提供不同的支付方式。 直接支付：短信验证码支付：二次确认支付： 3.翼支付客户端接口 3.1 账单支付功能接口 1.SDK包描述名称.jar为商户提供订单支付功能接口的开发包。 2、接口参数信息 参数名称是否可以为空 参数说明 参数长度 商户号； 商户唯一标识符； 例如：0000； 商户密钥； 例如：

4.2 订单金额不限； 单位（分）； 付款方式; 参数约定：1直接支付，2验证码支付，3二次确认支付； 产品代码; 产品数量； 游戏名称； 备注信息无限制； 153.2 接口配置信息 1、商品验证地址配置 如果商户需要商品验证功能，则商户需要提供“商品验证地址”供支付宝运营商配置。 如果商户未配置验证地址，则不会进行验证。 Yi支付交易引擎采用http协议，向商户提供验证地址，通过post发起验证请求。验证元素：商品码+订单

5.金额-单位：积分+产品描述+借方账号+订单号返回参数：true或。 后端通知地址配置后端通知地址用于通知商户支付结果反馈； 商户需要提供“后台通知地址”供翼支付操作人员配置。 商户配置支付结果通知地址后，将根据配置的地址进行支付结果通知。 通知接口定义： 参数 含义 类型 长度 必填 备注 订单号 an30 为商户提交的订单号。 订单请求支付流水号an30为商户的订单请求流水号。 该序列号在商户处必须是唯一的，并且每次发起支付时，它们对于支付平台都必须是唯一的。 交易序列号an30由支付平台提供，商户必须保存该信息。

6、作为对账依据，支付平台交易日期n8由支付平台提供。 商家必须保存此信息。 格式为：，商户对账和清算报告基于此日期。 订单交易金额n10的单位为：元。 交易状态an10为0000表示成功，其余表示失败（0000'：表示成功，9999：表示系统异常，未知错误，其他错误码：验证错误，支付失败描述） 交易结果描述为交易结果描述。 商户号n30是由易易支付网关平台统一分配的校验字段为md5汇总通知接口。 对应：类型长度为必填项。 注：表

7. 表明通知是一个真实值。 其他：表示失败通知接口说明： 1、商户需要验证mac验证域。 2、密钥由易支付网关支付平台分配给每个商户。 3. MAC验证确保支付平台交易信息的完整性。 MAC运算涉及的字符及其顺序如下： =XX&=XX&=XX&=XX&=XX&=XX&=XX&KEY=XX 易支付网关支付平台将使用以上按固定顺序组织的字符串，参数名称均为大写，使用标准md5算法汇总，然后转换为

8.转化为十六进制字符串，即为验证域MAC的值。 调用该接口时，将MAC值和支付结果通知信息提供给商户平台。 商户使用标准md5算法计算mac值，与合易支付网关比较支付平台提供的mac值。 如果一致，则说明该通知是由易支付网关支付平台提供的。 否则，即为虚假信息。 3.3 支付结果后台通知机制 1、易支付网关平台交易处理完成后，立即向商户发送通知。 如果60秒内没有收到响应，则重新发送，重复次数为3次（中间时间间隔，3分钟，5分钟，8分钟）。 如果没有回复，每隔半小时发送一次，直到第二天凌晨。 2、如果Yi支付网关平台收到商户的响应，则不再发送支付结果。 3、接口参数错误导致订单验证失败的通知仅发送一次。 4、商户端

9、如果未收到支付结果，可以先提示用户“支付结果查询已超时，如有疑问，请联系客服！”。 4.开发技巧 1）在文件.xml中添加以下权限

10.》/>注：如需适配6.0系统，请在调用接口前申请权限。 2）将res下的资源文件、so库等复制到需要集成项目的对应目录下.具体请参考）在.().pay(Ma

11. .this, , new () void () 支付成功回调时传递的参数 void (, , ) 支付失败回调时传递的参数，失败原因的简单描述 void () 用户取消支付回调为传递时传入的支付参数）； 1) 错误码描述： 错误码描述为空 101 产品信息错误 102 支付回调为空 104 支付参数错误（如：必填参数为空或参数长度过长） 电信不支持 106 支付类型错误 107 支付超时108 短信发送失败 109 交易频繁 14