SPay

isInstalled wxPay

概述

本模块封装了威富通微信支付开放SDK。适用于商户在移动端APP中集成微信支付功能。

商户APP调用微信提供的SDK调用微信，商户APP会跳转到微信，支付完后跳回到商户APP内，最后展示支付结果。

目前微信支付支持手机系统有：IOS（苹果）、Android（安卓）和WP（Windows Phone）。

有关威富通微信支付详情，参考威富通官网：

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

  • 名称：SPay
  • 参数：urlScheme、apiKey
  • 配置示例:

  • 字段描述:

    urlScheme：（必须配置）用于实现应用间跳转及数据交换，本应用可以启动微信客户端，也可以从微信客户端跳回本应用。urlScheme 的 value 值是从微信开放平台获取的 appid。appid 申请方法参考。

    apiKey：（必须配置）从微信开放平台获取的 appid，值与 urlScheme 相同。appid 申请方法参考微信开放平台接入文档。

注意：

iOS 平台上使用微信支付功能。需要在config里配置微信的白名单，否则无法跳转到微信APP支付。详情参考APICloud官方文档：

微信支付流程

1，移动端用户提交订单到商户服务器

2，商户服务器请求威富通支付网关

3，威富通支付网关返回威富通支付的 Token 给商户服务器

5，移动端唤起威富通支付SDK（本模块），同时传入威富通 Tken

6，威富通SDK（本模块）给威富通服务器发起支付请求

7，威富通服务器向微信服务器发起支付请求

8，微信服务器向威富通服务器返回支付授权 Token

9，威富通服务器给移动端返回支付授权 Token

10，移动端SDK 唤起微信进行支付，跳转到微信支付页面

11，用户提交交易

12，返回交易结果，并跳转回本 APP

13，移动端获取支付结果

12.1，微信服务器收到用户提交的交易请求后会异步通知威富通服务器

12.2，威富通服务器将结果返回给商家服务器

12.3，商户服务器通知威富通服务器已收到支付结果

12.4，威富通服务器通知微信支付服务器已收到支付结果

注意：过程 2和3 在商户服务器端进行。本模块封装了过程5-13，其中7、8、9是威富通服务器端自动处理。

isInstalled

判断当前设备是否安装微信客户端

ret：

  • 类型：JSON 对象
  • 内部字段：
  2.     installed: true      //布尔型；true||false，当前设备是否安装微信客户端

err：

  • 类型：JSON 对象
  • 内部字段：

示例代码

  1. var SPay = api.require('SPay');
  2. SPay.isInstalled(function(ret, err) {
  3.     if (ret.installed) {
  4.         alert("当前设备已安装微信客户端");
  5.     } else {
  6.         alert('当前设备未安装微信客户端');
  7.     }
  8. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

config

配置微信支付的appid

config({params}, callback(ret))

appId：

  • 类型：字符串
  • 描述：微信支付的appid

示例代码

可用性

iOS系统

可提供的1.0.0及更高版本

wxPay

调起微信支付

wxPay({params}, callback(ret))

amount：

  • 类型：数字
  • 描述：支付的金额精确到分，整数类型

token：

  • 类型：字符串
  • 描述：支支付授权码

service：

  • 类型：字符串
  • 描述：支付类型（如pay.weixin.app）

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  3.        payCode:,          //数字类型；支付返回状态码，详情参考下文附件
  4.     },
  5.     payDetail:{           //JSON对象；(Android无此字段)
  6.        body:'',           //字符串类型；商品描述
  7.        status:,           //数字类型；返回状态码
  8.        message:'',        //字符串类型；返回信息
  9.        money:,            //数字类型；支付金额 
  10.        out_trade:'',      //字符串类型；商户订单号
  11.        order_no:'',       //字符串类型；威富通订单号
  12.        transaction_id:'', //字符串类型；第三方订单号
  14.        trade_time:'',     //字符串类型；支付时间
  15.        need_query:'',     //字符串类型；统一反扫是否需要继续扫描标示（Y需要查询，N 不需要查询）
  16.        trade_type:''      //字符串类型；交易类型
  17.     }
  18. }

支付状态码

  1. var SPay = api.require('SPay');
  2. SPay.wxPay({
  3.     service: 'pay.weixin.app',
  4.     token: '147430b88ea3622250ae32eca5151ffba',
  5.     amount: 1
  6. }, function(ret) {
  8. });

可用性

可提供的1.0.0及更高版本