aliPayHK

来自于：官方立即使用

pay auth

概述

支付宝简介

支付宝（中国）网络技术有限公司是国内领先的第三方支付平台，致力于提供“简单、安全、快速”的支付解决方案。支付宝公司从2004年建立开始，始终以“信任”作为产品和服务的核心。旗下有“支付宝”与“支付宝钱包”两个独立品牌。自2014年第二季度开始成为当前全球最大的移动支付厂商。 支付宝主要提供支付及理财服务。包括网购担保交易、网络支付、转账、信用卡还款、手机充值、水电煤缴费、个人理财等多个领域。在进入移动支付领域后，为零售百货、电影院线、连锁商超和出租车等多个行业提供服务。还推出了余额宝等理财服务。

支付宝与国内外180多家银行以及VISA、MasterCard国际组织等机构建立战略合作关系，成为金融机构在电子支付领域最为信任的合作伙伴。

支付宝特色功能

钱包

支付宝也可以在智能手机上使用，该手机客户端为支付宝钱包。支付宝钱包具备了电脑版支付宝的功能，也因为手机的特性，内含更多创新服务。如“当面付”、“二维码支付”等。 还可以通过添加“服务”来让支付宝钱包成为自己的个性化手机应用。 支付宝钱包主要在iOS、Android上使用，iPad版与WP版正在开发中。

安全

支付涉及到用户的资金安全，因此遵循官方的安全规范至关重要。 如安全控件、短信校验服务、数字证书、第三方证书、支付盾、宝令、宝令手机版、安全保护问题、安全策略、手机安全设置等。 大多数的支付服务都可以使用支付宝。从购物到水电燃气缴费，且正有部分取代现金的趋势。

还款

2009年1月15日支付宝推出信用卡还款服务，国内39家银行发行的信用卡均支持。是最受欢迎的第三方还款平台。 主要优势：免费查信用卡账单、免费还款，还有自动还款/还款提醒等增值服务。推荐使用支付宝钱包。 2014年第一季度，76%的还信用卡是用支付宝钱包完成的。

转账

通过支付宝转账分为两种：1、转账到支付宝账号，资金瞬间到达对方支付宝账户；转账到支付宝账户的限额2、转账到银行卡，用户可以转账到自己或他人的银行卡，支持百余家银行，最快2小时到账。支持到账的银行和到账时间、转账到银行卡的限额 推荐使用支付宝钱包，免手续费。

缴费

2008年底开始，支付宝推进公共事业缴费服务，已经覆盖了全国300多个城市，支持1200多个合作机构。除了水电煤等基础生活缴费外，其还扩展到交通罚款、物业费、有线电视费等更多与老百姓生活息息相关的缴费领域。 常用的在线缴费服务有： 水电煤缴费、教育缴费、交通罚款、有线电视费

服务窗

在支付宝钱包的“服务”中添加相关服务账号，就能在钱包内获得更多服务。包括银行服务、缴费服务、保险理财、手机通讯服务、交通旅行、零售百货、医疗健康、休闲娱乐、美食吃喝等10余个类目。 区别于其他公众服务平台，服务窗具有天然的支付基因、超亿的支付用户群体、以及严格审核的商户服务，这使得服务窗产生更大的生态价值。

模块概述

aliPayHK封装了港版支付宝的SDK，开发者只需配置从支付宝申请的相应的参数即可将支付宝功能集成到自己的 app。若当前设备（客户端）未安装港版支付宝 app，则调用内嵌网页版支付。支付宝支付处理流程请参考支付宝官方文档 App 支付快速接入之第四步调用接口。 支付宝服务器端代码参考服务的SDK。

aliPayHK - 图1

不能同时添加的模块：ipayNow，pingpp，aliPay，aliPayTrade，aliPayTradePlus，aliPayPlus

支付宝使用注意：

  1. 此模块必须在真机环境下使用
  2. 使用前商户必须与支付宝公司签约获得appId、商家私钥。详情可参看支付宝文档开放平台应用创建指南
  3. 商家私钥的生成见支付宝官方相关文档生成与配置密钥

  4. 使用此模块前需先配置 config.xml文件，方法如下：

    • 名称：aliPayHK
    • 参数：urlScheme

    • 配置示例:

      1.   <feature name="aliPayHK">
      2.       <param name="urlScheme" value="alisdkdemo" />
      3.   </feature>

    • 字段描述：

      urlScheme：（必须配置）用于实现应用间跳转及数据交换，本应用可以启动支付宝客户端，也可以从支付宝客户端跳回本应用（此时需要云编译或自定义loader才能测试本功能）。urlScheme 的 value 值由字符串 ‘aliPayHK’ 和本应用的 widgetId 拼接而成

重要说明

模块中加签过程放在服务端完成；防止商户私密数据泄露，造成不必要的资金损失，及面临各种安全风险；

模块接口

pay

调用支付宝客户端支付

pay({params}, callback(ret, err))

params

orderString：

  • 类型：字符串
  • 描述：支付信息（由订单信息，签名，签名类型组成），支付信息生成（此过程可放在服务器端）可参照支付宝官方文档请求参数说明

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 1          //字符串类型；支付结果状态码，取值范围如下：
  3.                      //9000：支付成功
  4.                      //8000：正在处理中，支付结果未知（有可能已经支付成功），请查询商户订单列表中订单的支付状态
  5.                      //4000：订单支付失败
  6.                      //5000：重复请求
  7.                      //6001：用户中途取消支付操作
  8.                      //6002：网络连接出错
  9.                      //6004：支付结果未知（有可能已经支付成功），请查询商户订单列表中订单的支付状态
  10.                      //0001：缺少商户配置信息（商户id，支付公钥，支付密钥）
  11.                      //0002：缺少参数（subject、body、amount、tradeNO）
  12.                      //0003：签名错误（公钥私钥错误）
  13. }

示例代码

  1. var aliPayHK = api.require('aliPayHK');
  2. aliPayHK.pay({
  3.     orderString: 'partner="2088021966645500"&seller_id="testoverseas9191@alipay.com"&out_trade_no="RB280FBFEAI20BA"&subject="1"&body="我是测试数据"&total_fee="0.01"&notify_url="http://www.xxx.com"&service="mobile.securitypay.pay"&payment_type="1"&_input_charset="utf-8"&it_b_pay="30m"&show_url="m.alipay.com"&currency="HKD"&product_code="NEW_WAP_OVERSEAS_SELLER"&forex_biz="FP"&payment_inst="ALIPAYHK"&sign="GH6nmh7fAHBDISJidE5gBAA5NeDYYdH8%2BCj11prY27ednr2vmG4nR%2BvKBaHHpCSBufj%2Bb0AehneFX%2BCgVwt%2BS3YcgmlzDOdqGHTKEfH8xlZQ3w0FfbQg2TZdmeYn4Ds7w53eGyt0Sg7PssgUKiYSu8MRDvQbiemLahkex5Ir7Zg%3D"&sign_type="RSA"',
  4. }, function(ret, err) {
  5.     api.alert({
  6.         title: '支付结果',
  7.         msg: JSON.stringify(ret),
  8.         buttons: ['确定']
  9.     });
  10. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

auth

支付宝授权登录，参数及其回调详细说明参考 App支付宝登录授权SDK调用方法

auth({params}, callback(ret))

params

authInfoStr：

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.      resultStatus: '9000',    //字符串类型；本次操作的状态返回值，标识本次调用的结果，参见“resultStatus状态代码”。
  3.     result: 'success=true&auth_code=9c11732de44f4f1790b63978b6fbOX53&result_code=200&alipay_open_id=20881001757376426161095132517425&user_id=2088003646494707',                                
  4.                               //字符串类型；本次操作返回的结果数据。result_code具体状态码值请参见“result_code状态代码”。仅当resultStatus为“9000”且result_code为“200”时，代表授权成功。auth_code表示授权成功的授码。
  5.      memo:    '处理成功'           //字符串类型；保留参数，一般无内容。
  6. }

示例代码

  1. var aliPayHK = api.require('aliPayHK');
  2. aliPayHK.auth({
  3.     authInfoStr:'*****',
  4. }, function(ret) {
  5.     alert(JSON.stringify(ret));
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本