aUnifyPay

来自于:官方立即使用

概述

银联商务全民付移动支付APP综合支付控件,主要为合作商户的手机客户端提供安全、便捷的支付服务。合作商户的手机客户端通过集成全民付移动支付APP综合支付控件安全快速的唤起钱包 APP(云闪付、微信、支付宝等)完成支付。

全民付移动支付APP支付是由银联商务整合全民付(银商钱包)、云闪付、安卓PAY、微信、支付宝等多种钱包推出的手机支付产品,用户在银联商务签约的商户APP上进行付款时,可选择这些钱包进行支付。详情参考 银联商务官方文档

本模块封装了银联商务全民付移动支付APP综合支付控件的SDK,包括微信、支付宝、全民付(银商钱包)、云闪付、安卓PAY支付这五种支付方式。

注意:

  • 在 iOS 端支付宝渠道如果支付请求发送成功,则会跳转至支付宝APP,并且支付完成后会停留在支付宝,因此商户 APP无法通过callbackBlock收到支付结果,请以后台的支付结果为准。
  • 在 Android 端必须使用升级环境编译,且最低版本要求为 4.4.2

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

  • 名称:aUnifyPay
  • 参数:urlScheme、appId
  • 配置示例:
  <feature name="aUnifyPay">
    <param name="urlScheme" value="wxd0d84bbf23b4a0e4"/> 
    <param name="urlScheme" value="cloudPayBackUrl"/> 
    <param name="appId" value="wxd0d84bbf23b4a0e4"/>
  </feature>
  • 字段描述:

    urlScheme:(必须配置)用于实现应用间跳转及数据交换,本应用可以启动目标客户端(如微信),目标客户端依靠本参数跳回本应用。urlScheme 的 value 值是从目标 App 的开放平台获取的 appid,如 微信的 appid 申请方法参考 微信开放平台接入文档。也可以是自定义的,如云闪付 unifyPayBackUrl(必须是以cloudPay开头的字符串,如unifyPay20190723、unifyPayBackUrl、unifyPayDemo)。支持同时配置多个 urlScheme,若未开通相应的支付功能可不配置。

    appId:(必须配置)商户注册的微信支付appId。appid 申请方法参考微信开放平台接入文档

config 配置注意事项:

  1. 在 iOS 平台需配置 白名单。需配置 weixin、alipays、uppaysdk、uppaywallet、uppayx1、uppayx2、uppayx3 七个 item。示例如下:

    //多个值之间用英文逗号隔开
    <preference name="querySchemes" value="weixin,alipays,uppaysdk,uppaywallet,uppayx1,uppayx2,uppayx3" />
    
  2. 在android平台需要配置(iOS平台忽略此步骤),与其他使用百度地图模块可忽略此模块

    <meta-data name="com.baidu.lbsapi.API_KEY" value="d2oamESnhMkZykdI46rbubOf7sZ9ppGY"/>
    

    value:百度地图 apiKey

支付流程说明:

(1)用户在商户客户端中点击购买商品,商户客户端到商户后台发起下单;

(2)商户后台收到下单请求后,按照《银联商务全民付移动支付APP综合支付商户接入接口规范》文档要求向银商后台发送下单请求;

(3)银商后台接收到下单请求后,生成对应订单信息,并返回给商户后台(应答要素:appPayRequest等);

(4)商户后台接收订单信息,将订单信息返回至商户客户端;

(5)商户客户端使用订单信息(appPayRequest等)调用银商支付插件;

(6)银商支付插件根据传递订单信息唤起钱包APP(云闪付、微信、支付宝等)完成支付。

本模块封装了两套支付方案:一、通过 pay 接口,模块实现签名加密获取支付订单过程。此接口仅供开发阶段测试使用。正式上线请使用方案二;二、商户服务器端实现 1-4 步骤。获取支付的数据后调用 payWithData 接口支付。

pay

支付订单,本接口仅供开发阶段测试使用。

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

params

payChannel:

  • 类型:字符串
  • 描述:支付渠道
  • 取值范围:
    • wxPay 微信支付
    • aliPay 支付宝支付
    • cloudPay 云闪付 (传此参数时,config.xml 必须配置对应的 urlScheme)
    • posFastPay 全民付移动支付

merOrderId:

  • 类型:字符串
  • 描述:商户订单号

mid:

  • 类型:字符串
  • 描述:商户号

tid:

  • 类型:字符串
  • 描述:机构商户号

goods:

  • 类型:JSON类型
  • 描述:商品详情
  • 示例:{"goodsId":"666666",
      "goodsName":"unify测试商品",
      "quantity":"1",
      "price":"1",
      "goodsCategory":"测试商品分类",
      "body":"测试商品说明"}
    

totalAmount:

  • 类型:字符串
  • 描述:总金额,单位分

MD5Key:

  • 类型:字符串
  • 描述:MD5Key

msgSrc:

  • 类型:字符串
  • 描述:消息来源

urlStr:

  • 类型:字符串
  • 描述:下单接口URL

mobile:

  • 类型:字符串
  • 描述:手机号

merchantUserId:

  • 类型:字符串
  • 描述:商户用户号

notifyUrl:

  • 类型:字符串
  • 描述:通知地址

srcReserve:

  • 类型:字符串
  • 描述:商户定制化展示的内容,长度不大于255

secureTransaction:

  • 类型:布尔类型
  • 描述:(仅android支持)是否担保交易

msgId:

  • 类型:字符串类型
  • 描述:(仅android支持)消息id

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{ 
    resultCode:0000,     //字符串类型;支付请求是否发送成功(成功0000,失败-1)。商户订单是否成功支付应该以商户后台收到支付结果。(仅ios支持)
    resultInfo:'',       //数字类型;支付结果参数  (仅ios支持)
    resultMsg:''          //字符串类型;返回结果;(仅android支持)
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    code: 1000    //数字类型;
                  //错误码:
                  //1000(用户取消支付)
                  //1001(参数错误)
                  //1002(网络连接错误)
                  //1003 (支付客户端未安装)
                  //2001 (订单处理中,支付结果未知(有可能已经支付成功),请通过后台接口查询订单状态)
                  //2002 (订单号重复)
                  //2003 (订单支付失败)
                  //9999 (其他支付错误)
    msg: '' //字符串类型;支付失败描述 
}

示例代码

//支付宝支付 
var aUnifyPay = api.require('aUnifyPay');
aUnifyPay.pay({
    payChannel: 'aliPay',
    merOrderId: '1028201811201136',
    mid: '898310058124024',
    tid: 'ood12355', 
    goods: {"goodsId":"666666",
            "goodsName":"unify测试商品",
            "quantity":"1",
            "price":"1",
            "goodsCategory":"测试商品分类",
            "body":"测试商品说明"},
    totalAmount: '100',
    msgSrc:'NETPAY_DEMO',
    MD5Key: 'dwpRz2B6akcp8fwp6JJjenHCH7FKHFcCPE3NkiMJAQzhtD3W',
    urlStr:'https://qr-test1.chinaums.com/netpay-route-server/api/',
    msgId:'apicloud001',
    mobile:'18513952315',
    secureTransaction:false
}, function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

//微信支付

var aUnifyPay = api.require('aUnifyPay');
aUnifyPay.pay({
   payChannel:'wxPay',
   merOrderId:'38168548768586438',
   mid:'898310172770131',
   tid:'89BG1669', 
   goods:{"goodsId":"666666",
     "goodsName":"unify测试商品",
     "quantity":"1",
     "price":"1",
     "goodsCategory":"测试商品分类",
       "body":"测试商品说明"},
   totalAmount:'100',
   MD5Key:'fZjyfDK7ix7CKhhBSC8mQWTAtmp44JsTrbkkyKXtxNAxxPFT',
   msgSrc:'WWW.SHHXQWLKJ.COM',
   urlStr:'https://qr.chinaums.com/netpay-route-server/api/',
   merchantUserId:'3028201705071221163636273176',
   msgId:'dsa2231s',
   mobile:'18576825643',
   secureTransaction:false
 }, function(ret, err) {
     if (ret) {
         alert(JSON.stringify(ret));
     } else {
         alert(JSON.stringify(err));
     }
 });


 //云闪付支付 
var aUnifyPay = api.require('aUnifyPay');
aUnifyPay.pay({
    payChannel:'cloudPay',
    merOrderId:'5000201811191219',
    mid:'898310148160568',
    tid:'12345678', 
    goods:{"goodsId":"666666",
    "goodsName":"unify测试商品",
    "quantity":"1",
    "price":"100",
    "goodsCategory":"测试商品分类",
    "body":"测试商品说明"},
    totalAmount:'100',
    MD5Key:'AcZdi46z6GibDwi5WXQEdypEWt2WSdNH6RHT3YAwnmCWwQEG',
    msgSrc:'WWW.PRODTEST.COM',
    urlStr:'https://qr.chinaums.com/netpay-route-server/api/',
    msgId:'11023',
    secureTransaction:false
 }, function(ret, err) {
     if (ret) {
         alert(JSON.stringify(ret));
     } else {
         alert(JSON.stringify(err));
     }
 });
//全民付移动支付

var aUnifyPay = api.require('aUnifyPay');
aUnifyPay.pay({ 
          payChannel:'posFastPay',
         merOrderId:'30285629311191686',
         mid:'898310058124024',
         tid:'00000001', 
         merchantUserId:'3028201705071221163636273176',
         mobile:'18576825643',
         totalAmount:'100',
         msgSrc:'ERP_SCANPAY',
         MD5Key:'3ypmTzxdXhFty7HCrZynehjcjdcaAb3HDRwJQpTFYZfjWHEZ',
         urlStr:'https://qr.chinaums.com/netpay-route-server/api/',
         msgId:'apicloud001',
         secureTransaction:false
 }, function(ret, err) {
     if (ret) {
         alert(JSON.stringify(ret));
     } else {
         alert(JSON.stringify(err));
     }
 });

可用性

iOS 系统,Android 系统

可提供的 1.0.0 及更高版本

init

(仅android支持)初始化,android调用 pay 接口前需要先调用此接口

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

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:true,   //布尔类型;初始化成功
}

示例代码

var aUnifyPay = api.require('aUnifyPay');
aUnifyPay.init( function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

Android 系统

可提供的 1.0.0 及更高版本

payWithData

支付订单

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

params

channel:

  • 类型:字符串
  • 描述:支付渠道
  • 取值范围:
    • wxPay 微信支付
    • aliPay 支付宝支付
    • cloudPay 云闪付 (传此参数时,config.xml 必须配置对应的 urlScheme)
    • posFastPay 全民付移动支付

appPayRequest:

  • 类型:字符串
  • 描述:支付数据

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{ 
    resultCode:0000,     //字符串类型;支付请求是否发送成功(成功0000,失败-1)。商户订单是否成功支付应该以商户后台收到支付结果。(仅ios支持)
    resultInfo:'',       //数字类型;支付结果参数  (仅ios支持)
    resultMsg:''          //字符串类型;返回结果;(仅android支持)
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    code: 1000    //数字类型;
                  //错误码:
                  //1000(用户取消支付)
                  //1001(参数错误)
                  //1002(网络连接错误)
                  //1003 (支付客户端未安装)
                  //2001 (订单处理中,支付结果未知(有可能已经支付成功),请通过后台接口查询订单状态)
                  //2002 (订单号重复)
                  //2003 (订单支付失败)
                  //9999 (其他支付错误)
    msg: ''       //字符串类型;支付失败描述 
}

示例代码

var aUnifyPay = api.require('aUnifyPay');
aUnifyPay.payWithData({
    channel: 'posFastPay',
    appPayRequest: '*****' 
}, function(ret, err) {
    if (ret.resultCode == '0000') {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS 系统,Android 系统

可提供的 1.0.1 及更高版本