bcapplepay

来自于：BeeCloud

pay getApiVersion canMakeApplePayments

概述

本模块已停止更新维护，建议使用appleUnionPay模块。

bcapplepay 封装了Apple Pay(APPLE)支付接口。使用此模块可轻松完成Apple pay功能。

如需使用微信、支付宝、银联支付的模块请使用beecloud模块。

使用之前需要先到BeeCloud 注册认证，并快速开始接入BeeCloud Apple Pay。
更多信息请访问BeeCloud帮助中心 Apple Pay配置指导。

配置

注意: 使用此模块时,请勿同时勾选 appleUnionPay 模块.

使用此模块之前需先配置config文件的Feature

配置示例:

  1. <feature name="bcapplepay">
  2.     <param name="bcAppID" value="c5d1cba1-5e3f-4ba0-941d-9b0a371fe719" />
  3. </feature>

配置描述:

  1. 1.feature-name: bcapplepay.
  2. 2.param-bcAppID: BeeCloud平台AppID.

pay

支付
pay(params, callback);

params

title：

  • 类型：String
  • 默认值：无
  • 描述：订单描述。32个字节，最长支持16个汉字。

billno：

  • 类型：String
  • 默认值：无
  • 描述：订单号。8~32位字母和\或数字组合，必须保证在商户系统中唯一。建议根据当前时间生成订单号，格式为：yyyyMMddHHmmssSSS,”201508191436987”。

totalfee：

  • 类型：Int
  • 默认值：无
  • 描述：订单金额。以分为单位，例如：100代表1元。

optional：

  • 类型：Map(String, String)
  • 默认值：无
  • 描述：商户业务扩展，用于商户传递处理业务参数，会在webhook回调中返回。例：{‘userID’:’张三’,’mobile’:’0512-86861620’}

callback(ret, err)

ret:

  • 类型：JSON对象

内部字段：

  1. {
  2.     result_code: 0,  //返回码，0代表成功
  3.     result_msg: "支付成功", //返回信息
  4.     err_detail: "" //当result_code不为0时，返回具体fail原因 
  5. }

err:

  • 描述：所有信息都通过ret返回，err暂未启用。

示例代码

  1. var payData = {
  2.     title: "apicloud",
  3.     totalfee: 1,
  4.     billno: "201508191436987",
  5.     optional: { 'userID': '张三', 'mobile': '0512-86861620' }
  6. };
  8. var demo = api.require('bcapplepay');
  9. demo.pay(payData, payCallBack);
  11. function payCallBack(ret, err) {
  12.     api.toast({ msg: ret.result_msg });
  13. }

补充说明

回调样例：

  1. //成功
  2. {
  3.     result_code: 0,
  4.     result_msg: "支付成功",
  5.     err_detail: ""
  6. }
  7. //失败
  8. {
  9.     result_code: -1,
  10.     result_msg: "title 必须是长度不大于32个字节,最长16个汉字的字符串的合法字符串",
  11.     err_detail: "title 必须是长度不大于32个字节,最长16个汉字的字符串的合法字符串"
  12. }

可用性

iOS系统
可提供的1.0.0及更高版本

getApiVersion

获取API版本

getApiVersion(callback);

callBack(ret, err)

ret:

  • 类型：JSON对象

内部字段：

  1. {
  2.     apiVersion: "1.0.0" 
  3. }

示例代码

  1. var demo = api.require('bcapplepay');
  2. demo.getApiVersion(callBack);
  4. function callBack(ret, err) {
  5.     api.toast({ msg: ret.apiVersion });
  6. }

补充说明

无

可用性

iOS系统
可提供的1.0.0及更高版本

canMakeApplePayments

判断是否支持Apple Pay

canMakeApplePayments(params, callback);

params

cardType

  • 类型：Int
  • 默认值：0
  • 描述：0 代表不区分卡类型；1 代表借记卡；2 代表信用卡。

callBack(ret, err)

ret:

  • 类型：JSON对象

内部字段：

  1. {
  2.     status: true //支持
  3. }

示例代码

  1. var demo = api.require('bcapplepay');
  2. var params = {
  3.     cardType: 0
  4. };
  5. demo.canMakeApplePayments(params, callBack);
  7. function callBack(ret, err) {
  8.     api.toast({ msg: ret.status });
  9. }

补充说明

商户 App 在调用 Apple Pay 之前要注意根据此方法函数判断手机是否可用 Apple Pay 做应用内支付,从而判断是否显示 Apple Pay 支付按钮。

可用性

iOS系统 可提供的1.0.0及更高版本