BeeCloud Android SDK (Open Source)

简介

本项目的官方GitHub地址是 https://github.com/beecloud/beecloud-android

SDK支持以下支付渠道:

• 微信APP
• 支付宝APP
• 银联在线APP
• PayPal
• 百度钱包

包含预退款、订阅支付和相关的查询功能。
还提供了线下收款功能(包括微信扫码、微信刷卡、支付宝扫码、支付宝条形码)，订单状态的查询以及订单撤销。

流程

下图为整个支付的流程:

步骤①：（在App端）发送订单信息

做完这一步之后就会跳到相应的支付页面（如微信app中），让用户继续后续的支付步骤

步骤②：（在App端）处理同步回调结果

付款完成或取消之后，会回到客户app中，需要做相应界面展示的更新（比如弹出框告诉用户"支付成功"或"支付失败")。非常不推荐用同步回调的结果来作为最终的支付结果，因为同步回调可能（虽然可能性不大）出现结果不准确的情况，最终支付结果应以下面的异步回调为准。

步骤③：（在客户服务端）处理异步回调结果（Webhook）

付款完成之后，根据客户在BeeCloud后台的设置，BeeCloud会向客户服务端发送一个Webhook请求，里面包括了数字签名，订单号，订单金额等一系列信息。客户需要在服务端依据规则要验证数字签名是否正确，购买的产品与订单金额是否匹配，这两个验证缺一不可。验证结束后即可开始走支付完成后的逻辑。

导入SDK

1. 添加依赖

1. 推荐通过添加model的方式（适用于gradle，推荐直接使用Android Studio） 引入sdk model，在project的settings.gradle中include ':sdk'，并在需要支付的model（比如本项目中的demo） build.gradle中添加依赖compile project(':sdk')，需要JDK版本7或以上。

2. 对于需要以jar方式引入的情况
   添加第三方的支付类，在beecloud-android\demo_eclipse\libs目录下
   gson-2.4.jar为必须引入的jar，
   zxing-3.2.0.jar为生成二维码必须引入的jar，
   微信支付需要引入libammsdk.jar，
   支付宝需要引入alipaysdk.jar、alipayutdid.jar、alipaysecsdk.jar，
   银联需要引入UPPayAssistEx.jar，
   百度钱包支付需要引入Cashier_SDK-v4.2.0.jar，
   最后添加beecloud android sdk：beecloud-x.x.x.jar（如果你添加的是sdk目录下最新的jar，请手动添加其同级目录下依赖的okhttp-x.x.x.jar和okio-x.x.x.jar）

2.对于微信支付，需要注意你的AndroidManifest.xml中package需要和微信平台创建的移动应用应用包名保持一致，否则会遭遇一般错误

3.对于银联支付需要将银联插件beecloud-android\demo\src\main\assets\UPPayPluginEx.apk引入你的工程assets目录下

4.对于百度钱包支付，需要

1. 将beecloud-android\sdk\manualres\baidupay\res添加到你的res目录下；
2. 另外，对于使用Android Studio的用户，需要将beecloud-android\sdk\manualres\baidupay\目录下的armeabi文件夹拷贝到src\main\jniLibs目录下，如果没有jniLibs目录，请手动创建；对用使用Eclipse的用户，需要将beecloud-android\sdk\manualres\baidupay\目录下的armeabi文件夹拷贝到libs目录下。

5.对于需要使用PayPal的用户，由于PayPal官方不再提供单独的jar文件，请通过添加model的方式引入依赖。

使用方法

具体使用请参考项目中的demo

1.初始化支付参数

请参考demo中的ShoppingCartActivity.java

1 在主activity或者application的onCreate函数中初始化BeeCloud账户中的AppID和secret，并设置是否开启测试模式（如果不设置默认不开启）；注意：如果是测试模式，secret应该填Test Secret，如果是上线版本，应该填App Secret，例如

//开启测试模式
BeeCloud.setSandbox(true);
//此处第二个参数是控制台的test secret
BeeCloud.setAppIdAndSecret("c5d1cba1-5e3f-4ba0-941d-9b0a371fe719",
        "4bfdd244-574d-4bf3-b034-0c751ed34fee");

2 如果用到微信支付，在用到微信支付的Activity的onCreate函数里调用以下函数，第二个参数需要换成你自己的微信AppID，例如

BCPay.initWechatPay(ShoppingCartActivity.this, "wxf1aa465362b4c8f1");

3 如果用到PayPal，在用到PayPal的Activity的onCreate函数里调用函数，例如

BCPay.initPayPal(
    //在PayPal官网申请的APP Client ID
    "AVT1Ch18aTIlUJIeeCxvC7ZKQYHczGwiWm8jOwhrREc4a5FnbdwlqEB4evlHPXXUA67RAAZqZM0H8TCR", 
    //在PayPal官网申请的APP Secret   
    "EL-fkjkEUyxrwZAmrfn46awFXlX-h2nRkyCVhhpeVdlSRuhPJKXx3ZvUTTJqPQuAeomXA8PZ2MkX24vF",  
    //测试过程中使用BCPay.PAYPAL_PAY_TYPE.SANDBOX，生产环境使用BCPay.PAYPAL_PAY_TYPE.LIVE，不同的环境需要与Client ID和Secret相匹配
    BCPay.PAYPAL_PAY_TYPE.SANDBOX,  
    //是否显示收货地址，如果为TRUE，用户地址没有正确配置可能导致不能付款，该选项可以自行考量
    Boolean.FALSE
    );

2. 在AndroidManifest.xml中添加permission

<!-- for all -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

<!-- for Baidu -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.READ_SMS" />

3. 在AndroidManifest.xml中注册activity

如果开启测试模式，需要添加（上线版本不需要）

<activity
    android:name="cn.beecloud.BCMockPayActivity"
    android:screenOrientation="portrait"
    android:theme="@android:style/Theme.Translucent.NoTitleBar" />

对于微信支付，需要添加

<activity
    android:name="cn.beecloud.BCWechatPaymentActivity"
    android:launchMode="singleTop"
    android:theme="@android:style/Theme.Translucent.NoTitleBar" />

<activity-alias
    android:name=".wxapi.WXPayEntryActivity"
    android:exported="true"
    android:targetActivity="cn.beecloud.BCWechatPaymentActivity" />

对于支付宝，需要添加

<activity
    android:name="com.alipay.sdk.app.H5PayActivity"
    android:configChanges="orientation|keyboardHidden|navigation"
    android:exported="false"
    android:screenOrientation="behind"
    android:windowSoftInputMode="adjustResize|stateHidden" />

对于银联，需要添加

<activity
    android:name="cn.beecloud.BCUnionPaymentActivity"
    android:configChanges="orientation|keyboardHidden"
    android:excludeFromRecents="true"
    android:launchMode="singleTop"
    android:screenOrientation="portrait"
    android:theme="@android:style/Theme.Translucent.NoTitleBar"
    android:windowSoftInputMode="adjustResize" />

对于PayPal，需要添加

<activity
    android:name="cn.beecloud.BCPayPalPaymentActivity"
    android:configChanges="orientation|keyboardHidden"
    android:excludeFromRecents="true"
    android:launchMode="singleTop"
    android:screenOrientation="portrait"
    android:theme="@android:style/Theme.Translucent.NoTitleBar"
    android:windowSoftInputMode="adjustResize" />

对于百度钱包，由于需要添加的activity数量众多，请参考demo中的AndroidManifest.xml

4.支付

请查看doc中的API，支付类BCPay，参照demo中ShoppingCartActivity

原型：

通过BCPay的实例，以reqWXPaymentAsync方法发起微信支付请求。
通过BCPay的实例，以reqAliPaymentAsync方法发起支付宝支付请求。
通过BCPay的实例，以reqUnionPaymentAsync方法发起银联支付请求。
通过BCPay的实例，以reqBaiduPaymentAsync方法发起百度钱包支付请求。
通过BCPay的实例，以reqPayPalPaymentAsync方法发起PayPal支付请求。

参数依次为

billTitle 商品描述, 32个字节内, 汉字以2个字节计
billTotalFee 支付金额，以分为单位，必须是正整数
billNum 商户自定义订单号，PayPal不需要该参数
optional 为扩展参数，可以传入任意数量的key/value对来补充对业务逻辑
callback 支付完成后的回调入口

或者，通过BCPay的实例，以reqPaymentAsync方法发起所有支持的支付请求，该方法的调用请参考demo中百度钱包的支付调用，BCPay.PayParams参数请参阅API。
参数依次为

payParam BCPay.PayParams类型
callback 支付完成后的回调入口

在回调函数中将BCResult转化成BCPayResult之后做后续处理
调用：（以微信为例）

//定义回调
BCCallback bcCallback = new BCCallback() {
    @Override
    public void done(final BCResult bcResult) {
        //此处根据业务需要处理支付结果
        final BCPayResult bcPayResult = (BCPayResult)bcResult;
        
        switch (bcPayResult.getResult()) {
            case BCPayResult.RESULT_SUCCESS:
                //用户支付成功
                break;
            case BCPayResult.RESULT_CANCEL:
                //用户取消支付"
                break;
            case BCPayResult.RESULT_FAIL:
                //支付失败
        }
    }
};

//调用支付接口
Map<String, String> mapOptional = new HashMap<>();
mapOptional.put("testkey1", "测试value值1");

//发起支付
BCPay.getInstance(ShoppingCartActivity.this).reqWXPaymentAsync(
    "微信支付测试",               //订单标题
    1,                           //订单金额(分)
    billNum,  //订单流水号
    mapOptional,            //扩展参数(可以null)
    bcCallback);            //支付完成后回调入口

对于PayPal支付的补充说明

PayPal回调返回的成功表示手机支付已经完成，但是订单还没有同步到BeeCloud服务器，由于同步过程中sdk需要先向PayPal服务器请求token，该请求过程失败几率相对比较大，所以可能需要多次请求同步，如果依然失败，请保留订单数据用于下次同步，同步接口为syncPayPalPayment，例如：

//如果是PayPal，detail info里面包含订单的json字符串
final String syncStr = bcPayResult.getDetailInfo();

BCCache.executorService.execute(new Runnable() {
    @Override
    public void run() {
        BCPayResult syncResult;
        int i = 0;
        //由于同步过程中需要向PayPal服务器请求token，请求失败的几率比较高，此处设置了三次循环
        for (; i < 3; i++) {
            syncResult = BCPay.getInstance(ShoppingCartActivity.this).syncPayPalPayment(syncStr);

            if (syncResult.getResult().equals(BCPayResult.RESULT_SUCCESS)) {
                //sync succ
                break;
            } else {
                //sync fail reason: syncResult.getDetailInfo());
            }
        }

        //注意，如果一直失败，你需要将该json串保留起来，下次继续同步，否者在你在BeeCloud控制台看不到这笔订单
        if (i == 3) {
            //please store the json string to somewhere for later sync: syncStr
        }
    }
});

5.线下支付

请查看doc中的API，线下支付类BCOfflinePay，参照demo中QRCodeEntryActivity和其关联的activity；一般用于线下门店通过出示二维码由用户扫描付款，或者通过用户出示的付款码收款。
线下支付基本流程：

1 通过二维码或者付款码发起支付；
2 支付结束后调用查询接口确认BCQuery.getInstance().queryOfflineBillStatusAsync,请参考查询部分说明。
第二步必不可少。

原型：

通过BCOfflinePay的实例，以reqQRCodeAsync方法请求生成支付二维码。
通过BCOfflinePay的实例，以reqOfflinePayAsync方法通过获取到的付款码发起收款。

公用参数依次为

channelType BCChannelTypes类型，二维码支持WX_NATIVE，ALI_OFFLINE_QRCODE，扫码支付支持WX_SCAN, ALI_SCAN
billTitle 商品描述, 32个字节内, 汉字以2个字节计
billTotalFee 支付金额，以分为单位，必须是正整数
billNum 商户自定义订单号
optional 为扩展参数，可以传入任意数量的key/value对来补充对业务逻辑
callback 支付完成后的回调入口

请求生成支付二维码的额外参数

genQRCode 是否生成QRCode Bitmap 如果为false，请自行根据getQrCodeRawContent返回的URL，使用BCPay.generateBitmap方法生成支付二维码，你也可以使用自己熟悉的二维码生成工具

qrCodeWidth 如果生成二维码(genQRCode为true), QRCode的宽度(以px为单位), null则使用默认参数360px

请求通过获取到的付款码发起收款的额外参数

authCode 用户出示的收款码
terminalId 机具终端编号，支付宝扫码(ALI_SCAN)的选填参数
storeId 商户门店编号，支付宝扫码(ALI_SCAN)的选填参数

对于生成二维码的请求，在回调函数中将BCResult转化成BCQRCodeResult之后做后续处理
调用：

BCOfflinePay.getInstance().reqQRCodeAsync(
        channelType,		//渠道类型
        billTitle,  		//商品描述
        1,          		//总金额, 以分为单位, 必须是正整数
        billNum,          	//流水号
        optional,           //扩展参数
        true,               //是否生成二维码的bitmap
        380,                //二维码的尺寸, 以px为单位, 如果为null则默认为360
        new BCCallback() {
            @Override
            public void done(BCResult bcResult) {

                final BCQRCodeResult bcqrCodeResult = (BCQRCodeResult) bcResult;

                //resultCode为0表示请求成功
                if (bcqrCodeResult.getResultCode() == 0) {
                    //如果你设置了生成二维码参数为true那么此处可以获取二维码
                    qrCodeBitMap = bcqrCodeResult.getQrCodeBitmap();

                    //否则通过 bcqrCodeResult.getQrCodeRawContent() 获取二维码的内容，自己去生成对应的二维码

                } else {
                    //deal with err msg
                }
            }
        });

对于通过用户出示的付款码收款，在回调函数中将BCResult转化成BCPayResult之后做后续处理
调用：

BCOfflinePay.getInstance().reqOfflinePayAsync(
        channelType,
        billTitle, //商品描述
        1,                 			//总金额, 以分为单位, 必须是正整数
        billNum,          			//流水号
        optional,            		//扩展参数
        authCode,           		//付款码
        "fake-terminalId",  		//若机具商接入terminalId(机具终端编号)必填
        null,               		//若系统商接入，storeId(商户门店编号)必填
        new BCCallback(){...});

• 关于订单的撤销

支持WX_SCAN, ALI_OFFLINE_QRCODE, ALI_SCAN
订单撤销后，用户将不能继续支付，这和退款是不同的操作，具体请参考GenQRCodeActivity

BCOfflinePay.getInstance().reqRevertBillAsync(
    channelType,
    billNum,        //需要撤销的订单号
    new BCCallback(){...})

• 关于支付宝内嵌二维码

支付宝内嵌二维码属于线上产品，支付结果会及时反馈，并不需要额外的查询操作，具体可以参考QRCodeEntryActivity和ALIQRCodeActivity，注意需要通过BCPay调用

BCPay.getInstance(QRCodeEntryActivity.this).reqAliInlineQRCodeAsync(
		"支付宝内嵌二维码支付测试",   	//商品描述
        1,                            	//总金额, 以分为单位, 必须是正整数
        billNum,      	                //流水号
        mapOptional,                    //扩展参数
        "https://beecloud.cn/",  		//returnUrl，支付成功之后的返回url
        "1",                          	//qrPayMode，二维码类型
        new BCCallback(){...});

请求生成支付宝内嵌支付二维码的特有参数说明

returnUrl 支付成功后的同步跳转页面, 必填
qrPayMode 支付宝内嵌二维码类型

可选项
"0": 订单码-简约前置模式, 对应 iframe 宽度不能小于 600px, 高度不能小于 300px
"1": 订单码-前置模式, 对应 iframe 宽度不能小于 300px, 高度不能小于 600px
"3": 订单码-迷你前置模式, 对应 iframe 宽度不能小于 75px, 高度不能小于 75px

6.预退款

预退款结束后仍然需要在server端发起预退款批量审核，以达到真实退款的目的。

原型：

通过构造BCPay的实例，使用prefund方法发起预退款；在回调函数中将BCResult转化成BCRefundResult之后做后续处理；可参照demo中BillListActivity

调用：

BCPay.RefundParams params = new BCPay.RefundParams();
//退款单号
params.refundNum = "20160621162753241";
//需要退款的订单号
params.billNum = "20160621162735489";
//退款金额，必须为正整数，单位为分
params.refundFee = 10;
BCPay.getInstance(YourActivity.this).prefund(params, bccallback);

7.查询

• 查询支付订单

请查看doc中的API，查询类BCQuery，参照demo中BillListActivity

原型：

通过构造BCQuery的实例，使用queryBillsAsync方法发起支付查询，channel指代何种支付方式，为BCReqParams.BCChannelTypes.ALL时则查询所有的支付渠道订单；在回调函数中将BCResult转化成BCQueryBillsResult之后做后续处理

调用：

//回调入口
final BCCallback bcCallback = new BCCallback() {
    @Override
    public void done(BCResult bcResult) {
    	//根据需求处理结果数据

        final BCQueryBillsResult bcQueryResult = (BCQueryBillsResult) bcResult;

        //resultCode为0表示请求成功
        if (bcQueryResult.getResultCode() == 0) {
			//订单列表
	        bills = bcQueryResult.getBills();
        } else {
            //deal with err msg
        }
    }
};

//发起查询请求
BCQuery.getInstance().queryBillsAsync(
    BCReqParams.BCChannelTypes.UN_APP,      //渠道
    null,                                   //订单号
    startTime.getTime(),                    //订单生成时间
    endTime.getTime(),                      //订单完成时间
    2,                                      //跳过满足条件的前2条数据
    15,                                     //返回满足条件的15条数据
    bcCallback);

• 查询退款订单

请查看doc中的API，查询类BCQuery，参照demo中RefundOrdersActivity

原型：

通过构造BCQuery的实例，使用queryRefundsAsync方法发起退款查询，channel指代何种支付方式，为BCReqParams.BCChannelTypes.ALL时则查询所有的支付渠道退款订单；在回调函数中将BCResult转化成BCQueryRefundsResult之后做后续处理

调用：
同上，首先初始化回调入口BCCallback

BCQuery.getInstance().queryRefundsAsync(
    BCReqParams.BCChannelTypes.UN,          //渠道
    null,                                   //订单号
    null,                                   //商户退款流水号
    startTime.getTime(),                    //退款订单生成时间
    endTime.getTime(),                      //退款订单完成时间
    1,                                      //跳过满足条件的前1条数据
    15,                                     //返回满足条件的15条数据
    new BCCallback(){...});

• 查询订单数目

请查看doc中的API，查询类BCQuery，参照demo中BillListActivity和RefundOrdersActivity

原型：

通过构造BCQuery的实例，使用queryBillsCountAsync方法发起支付订单数目查询，使用queryRefundsCountAsync方法发起退款订单数目查询；在回调函数中将BCResult转化成BCQueryCountResult之后做后续处理

调用：
以查询支付订单数目为例

BCQuery.QueryParams params = new BCQuery.QueryParams();

//以下为可用的限制参数
//渠道类型
params.channel = BCReqParams.BCChannelTypes.ALL;

//支付单号
//params.billNum = "your bill number";

//订单是否支付成功
params.payResult = Boolean.TRUE;

//限制起始时间
params.startTime = startTime.getTime();

//限制结束时间
params.endTime = endTime.getTime();

BCQuery.getInstance().queryBillsCountAsync(params, new BCCallback(){...});

• 查询订单退款状态

请查看doc中的API，查询类BCQuery，参照demo中RefundStatusActivity

原型：

通过构造BCQuery的实例，使用queryRefundStatusAsync方法发起支付查询，该方法所有参数都必填，channel指代何种支付方式，目前由于第三方API的限制仅支持微信、易宝、快钱和百度；在回调函数中将BCResult转化成BCRefundStatus之后做后续处理

调用：
同上，首先初始化回调入口BCCallback

BCQuery.getInstance().queryRefundStatusAsync(
    BCReqParams.BCChannelTypes.WX,     //目前仅支持WX、YEE、KUAIQIAN、BD
    "20150520refund001",                   //退款单号
    new BCCallback(){...});                           //回调入口

• 根据ID查询订单

请查看doc中的API，查询类BCQuery，注意此处的ID不是订单号，是在发起支付或者退款的时候返回的唯一标识符。

原型：

通过BCQuery的实例，以queryBillByIDAsync方法发起支付订单查询，查询结果转化成BCQueryBillResult做后续处理，请参照demo中ShoppingCartActivity。
通过BCQuery的实例，以queryRefundByIDAsync方法发起退款订单查询，查询结果转化成BCQueryRefundResult做后续处理，请参照demo中RefundOrdersActivity。

调用：
同上，首先初始化回调入口BCCallback

BCQuery.getInstance().queryBillByIDAsync(
                id,
                new BCCallback(){...});

• 查询线下订单状态

请查看doc中的API，查询类BCQuery，参照demo中GenQRCodeActivity

原型：

通过BCQuery的实例，以queryOfflineBillStatusAsync方法发起支付订单查询，查询结果转化成BCBillStatus做后续处理，请参照demo中ShoppingCartActivity。

调用：
同上，首先初始化回调入口BCCallback

BCQuery.getInstance().queryOfflineBillStatusAsync(
        channelType,		//渠道类型
        billNum,			//支付订单号
        new BCCallback() {
            @Override
            public void done(BCResult result) {
                BCBillStatus billStatus = (BCBillStatus) result;
                //表示支付成功
                if (billStatus.getResultCode() == 0 &&
                        billStatus.getPayResult()) {
                    //TODO
                } else {
                    //deal with err msg
                }
            }
        }
);

8.订阅支付

先查看订阅系统说明文档了解基础概念，开发过程中如果对相关变量命名有疑惑，查看API References

• 查询计划列表

原型：

通过BCQuery的实例，以queryPlans方法查询计划列表，查询结果转化成BCPlanListResult后通过getPlans获取计划列表，请参照demo中SubscribeActivity。
queryPlans的参数BCPlanCriteria可以设置只查询总个数 setCountOnly(true)，结果可以通过getTotalCount获取。

调用：

同上，首先初始化回调入口BCCallback

// 参照API添加查询计划限制条件
BCPlanCriteria criteria = new BCPlanCriteria();
// 比如限制最多返回8条记录
criteria.setLimit(8);
// 比如只返回计划名包含"plan"的
criteria.setNameWithSubstring("plan");

BCQuery.getInstance().queryPlans(criteria,
        new BCCallback() {...});

• 订阅支付支持的银行列表

原型：

通过BCQuery的实例，以subscriptionSupportedBanks方法查询，操作结果转化成BCSubscriptionBanksResult做后续处理，请参照demo中SubscribeActivity。
如果查询成功，结果中包含支持的常用银行列表和所有支持的银行列表，后者包含前者。

调用：

同上，首先初始化回调入口BCCallback

BCQuery.getInstance().subscriptionSupportedBanks(new BCCallback() {...});

• 发送验证码

原型：

通过BCPay的实例，以sendSmsCode方法发送验证码，操作结果转化成BCSmsResult做后续处理，请参照demo中SubscribeActivity。
如果发送成功，返回结果包含smsId，同时发送smsCode到用户手机。

调用：

同上，首先初始化回调入口BCCallback

BCPay.getInstance(this).sendSmsCode("接收验证码的手机号",new BCCallback() {...});

• 发起订阅

原型：

通过BCPay的实例，以subscribe方法发起订阅，操作结果转化成BCSubscriptionResult做后续处理，请参照demo中SubscribeActivity。
subscribe的验证码参数可以通过上文的sendSmsCode获取，返回结果包含BCSubscription对象，如果该对象isValid返回true表明本次订阅已经即时生效，否则你还需要等待webhook推送最终审核结果。

调用：

同上，首先初始化回调入口BCCallback

BCSubscription subscription = new BCSubscription();
subscription.setBuyerId("buyer id");
subscription.setPlanId("plan id");
subscription.setBankName("like中国银行");
subscription.setCardNum("bank card number");
subscription.setIdName("身份证姓名");
subscription.setIdNum("身份证号");
subscription.setMobile("和银行卡绑定的手机号");

// 第四个参数用于后期优惠码，目前请填null
BCPay.getInstance(this).subscribe(subscription, smsId, smsCode, null,
		new BCCallback() {...});

• 取消订阅

原型：

通过BCPay的实例，以cancelSubscription方法发送取消请求，操作结果转化成BCObjectIdResult做后续处理，请参照demo中SubscriptionListActivity。
如果请求成功，返回结果getResultCode应当为0，getId返回本次取消的订阅id。

调用：

同上，首先初始化回调入口BCCallback

BCPay.getInstance(this).cancelSubscription("需要取消的订阅id",new BCCallback() {...});

• 查询订阅列表

原型：

通过BCQuery的实例，以querySubscriptions方法查询计划列表，查询结果转化成BCSubscriptionListResult后通过getSubscriptions获取订阅列表，请参照demo中SubscriptionListActivity。
querySubscriptions的参数BCSubscriptionCriteria可以设置只查询总个数 setCountOnly(true)，结果可以通过getTotalCount获取。

调用：

同上，首先初始化回调入口BCCallback

// 参照API添加查询订阅限制条件
BCSubscriptionCriteria criteria = new BCSubscriptionCriteria();
// 比如限制最多返回10条记录
criteria.setLimit(10);
// 比如只返回订阅用户id是ohmy的记录
criteria.setBuyerId("ohmy");

BCQuery.getInstance().querySubscriptions(criteria,
        new BCCallback() {...});

Demo

考虑到个人的开发习惯，本项目提供了Android Studio和Eclipse ADT两种工程的demo，为了使demo顺利运行，请注意以下细节

1. 对于使用Android Studio的开发人员，下载源码后可以将demo_eclipse移除，Import Project的时候选择beecloud-android，sdk为demo的依赖model，gradle会自动关联。
2. 对于使用Eclipse ADT的开发人员，Import Project的时候选择beecloud-android下的demo_eclipse，该demo下面已经添加所有需要的jar。

ProGuard

请根据自己引进的jar做增删

#第三方库的申明，注意在Android Studio中不需要
#BeeCloud及依赖jar
-libraryjars libs/beecloud-x.x.x.jar
-libraryjars libs/gson-2.4.jar
-libraryjars libs/zxing-3.2.0.jar
#支付宝
-libraryjars libs/alipaysdk.jar
-libraryjars libs/alipaysecsdk.jar
-libraryjars libs/alipayutdid.jar
#微信
-libraryjars libs/libammsdk.jar
#银联
-libraryjars libs/UPPayAssistEx.jar
#百度
-libraryjars libs/Cashier_SDK-v4.2.0.jar

#以下是Android Studio和Eclipse都必须的
#BeeCloud
-dontwarn cn.beecloud.**

#保留类签名声明
-keepattributes Signature
#BeeCloud
-keep class cn.beecloud.** { *; }
-keep class com.google.** { *; }
#支付宝
-keep class com.alipay.** { *; } 
#微信
-keep class com.tencent.** { *; } 
#银联
-keep class com.unionpay.** { *; } 
#百度
-keep class com.baidu.** { *; }
-keep class com.dianxinos.** { *; }

#Android Studio中包含PayPal依赖，需要添加
-dontwarn com.paypal.**
-dontwarn io.card.payment.**
-dontwarn okhttp3.**
-dontwarn okio.**

-keep class com.paypal.** { *; }
-keep class io.card.payment.** { *; }

-keep interface okhttp3.** { *; }
-keep interface okio.** { *; }

-keep class okhttp3.** { *; }
-keep class okio.** { *; }

常见问题

请查看帮助中心