The beecloud-java from dwyzlx

BeeCloud Java SDK (Open Source)

简介

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

本SDK的是根据BeeCloud Rest API开发的Java SDK，适用于JRE 1.6及以上平台。可以作为调用BeeCloud Rest API的示例或者直接用于生产。

安装

1.从github下载带依赖的jar文件,然后导入到自己的工程依赖包中

2.若是工程采用maven进行依赖配置，可在自己工程的pom.xml文件里加入以下配置

<dependency>   
    <groupId>cn.beecloud</groupId>
    <artifactId>beecloud-java-sdk</artifactId>
    <version>3.1.3</version>
</dependency>

工程名以及版本号需要保持更新。（更新可参考本项目的pom.xml，文件最顶端）

注册

三个步骤，2分钟轻松搞定：

注册开发者：猛击这里注册成为BeeCloud开发者
注册应用：使用注册的账号登陆控制台后，点击"+创建App"创建新应用
在代码中注册：

BeeCloud.registerApp(appId, testSecret, appSecret, masterSecret);

LIVE模式使用方法

BeeCloud.registerApp(appId, testSecret, appSecret, masterSecret);

LIVE模式testSecret可为null

默认开启LIVE模式

SANDBOX模式使用方法

BeeCloud.registerApp(appId, testSecret, appSecret, masterSecret);
BeeCloud.setSandbox(true);

SANDBOX模式appSecret、masterSecret可为null

设置sandbox属性为true，开启SANDBOX模式

LIVE模式部分

国际支付

国际支付接口接收BCInternationlOrder参数对象，该对象封装了发起国际支付所需的各个具体参数。

成功发起国际支付接口将会返回带objectId的BCInternationlOrder对象。

若是跳转至paypal支付，返回的BCInternationlOrder对象包含跳转支付url，用户跳转至此url，登陆paypal便可完成支付。若是直接使用信用卡支付，直接支付成功，返回的BCInternationlOrder对象包含信用卡ID，此ID在快捷支付时需要。
若是通过信用卡ID支付，直接支付成功。

发起国际支付异常情况将抛出BCException, 开发者需要捕获此异常进行相应失败操作开发者可根据异常消息判断异常的具体信息，异常信息的格式为"resultCode:xxx;resultMsg:xxx;errDetail:xxx"。

PAYPAL内支付

BCInternationlOrder internationalOrder = new BCInternationlOrder();
/*
 * PAYPAL内支付
 */
internationalOrder.setChannel(PAY_CHANNEL.PAYPAL_PAYPAL);
internationalOrder.setBillNo(billNo);
internationalOrder.setCurrency(PAYPAL_CURRENCY.USD);
internationalOrder.setTitle("paypal test");
internationalOrder.setTotalFee(1);
internationalOrder.setReturnUrl(paypalReturnUrl);
 try {
	 internationalOrder = BCPay.startBCInternatioalPay(internationalOrder);
	 out.println(internationalOrder.getObjectId());
     response.sendRedirect(internationalOrder.getUrl());
 } catch (BCException e) {
     log.error(e.getMessage(), e);
     out.println(e.getMessage());
 }

PAYPAL信用卡支付

BCInternationlOrder internationalOrder = new BCInternationlOrder();
/*
 * 信用卡支付
 */
CreditCardInfo creditCardInfo = new CreditCardInfo();
creditCardInfo.setCardNo("5183182005528540");
creditCardInfo.setExpireMonth(11);
creditCardInfo.setExpireYear(19);
creditCardInfo.setCvv(350);
creditCardInfo.setFirstName("SAN");
creditCardInfo.setLastName("ZHANG");
creditCardInfo.setCardType(CARD_TYPE.mastercard);
internationalOrder.setBillNo(billNo);
internationalOrder.setChannel(PAY_CHANNEL.PAYPAL_CREDITCARD);
internationalOrder.setCreditCardInfo(creditCardInfo);
internationalOrder.setCurrency(PAYPAL_CURRENCY.USD);
internationalOrder.setTitle("paypal credit card test");
internationalOrder.setTotalFee(1);
try {
   	internationalOrder = BCPay.startBCInternatioalPay(internationalOrder);
   	out.println(internationalOrder.getObjectId());
   	out.println("PAYPAL_CREDITCARD 支付成功！");
   	out.println(internationalOrder.getCreditCardId());
   	request.getSession().setAttribute("creditCardId", internationalOrder.getCreditCardId());//存储信用卡ID
} catch (BCException e) {
    log.error(e.getMessage(), e);
    out.println(e.getMessage());
}

PAYPAL信用卡ID支付

/*
 * 信用卡ID支付
 */
internationalOrder.setBillNo(billNo);
internationalOrder.setChannel(PAY_CHANNEL.PAYPAL_SAVED_CREDITCARD);
internationalOrder.setCurrency(PAYPAL_CURRENCY.USD);
internationalOrder.setTitle("PAYPAL_SAVED_CREDITCARD test");
internationalOrder.setTotalFee(1);
internationalOrder.setBillNo(request.getSession().getAttribute("creditCardId").toString());//使用信用卡ID
try {
   	internationalOrder = BCPay.startBCInternatioalPay(internationalOrder);
   	out.println(internationalOrder.getObjectId());
   	out.println("PAYPAL_SAVED_CREDITCARD 支付成功！");
} catch (BCException e) {
    log.error(e.getMessage(), e);
    out.println(e.getMessage());
}

代码中的参数对象BCInternationlOrder封装字段含义如下：

key	说明
channel	渠道类型，根据不同场景选择不同的支付方式，包含： PAYPAL_PAYPAL paypal内支付 PAYPAL_CREDITCARD 使用信用卡支付 PAYPAL_SAVED_CREDITCARD 使用存储的信用卡id支付（必填）
totalFee	订单总金额，只能为整数，单位为分，例如 1，（必填）
billNo	商户订单号, 8到32个字符内，数字和/或字母组合，确保在商户系统中唯一, 例如(201506101035040000001),（必填）
title	订单标题， 32个字节内，最长支持16个汉字，（必填）
currency	货币种类代码，包含： AUD BRL CAD CZK DKK EUR HKD HUF ILS JPY MYR MXN TWD NZD NOK PHP PLN GBP SGD SEK CHF THB TRY THB USD（必填）
creditCardInfo	信用卡信息，当channel为PAYPAL_CREDITCARD必填，（选填）
creditCardId	信用卡id，当使用PAYPAL_CREDITCARD支付完成后会返回一个信用卡id，当channel为PAYPAL_SAVED_CREDITCARD必填，（选填）
returnUrl	同步返回页面，支付渠道处理完请求后,当前页面自动跳转到商户网站里指定页面的http路径。当channel为PAYPAL_PAYPAL时为必填，（选填）
objectId	境外支付订单唯一标识, 下单成功后返回
url	当channel 为PAYPAL_PAYPAL时返回，跳转支付的url

信用卡信息对象CreditCardInfo封装字段含义如下：

key	说明
cardNo	卡号，（必填）
expireMonth	过期时间中的月，（必填）
expireYear	过期时间中的年，（必填）
cvv	信用卡的三位cvv码，（必填）
firstName	用户名字，（必填）
lastName	用户的姓，（必填）
cardType	卡类别 visa/mastercard/discover/amex，（必填）

国内支付

国内支付接口接收BCOrder参数对象，该对象封装了发起国内际支付所需的各个具体参数。

成功发起国内支付接口将会返回带objectId的BCOrder对象。

发起国内支付异常情况将抛出BCException, 开发者需要捕获此异常进行相应失败操作开发者可根据异常消息判断异常的具体信息，异常信息的格式为"resultCode:xxx;resultMsg:xxx;errDetail:xxx"。

支付宝网页调用

返回的BCOrder对象包含表单支付html和跳转支付url,开发者提交支付表单或者跳转至url完成支付。

BCOrder bcOrder = new BCOrder(PAY_CHANNEL.ALI_WEB, 1, billNo, title);
bcOrder.setBillTimeout(360);
bcOrder.setReturnUrl(aliReturnUrl);
try {
    bcOrder = BCPay.startBCPay(bcOrder);
    out.println(bcOrder.getObjectId());
    Thread.sleep(3000);
    out.println(bcOrder.getHtml());
} catch (BCException e) {
    log.error(e.getMessage(), e);
    out.println(e.getMessage());
}

支付宝移动网页调用

返回的BCOrder对象包含表单支付html和跳转支付url,开发者提交支付表单或者跳转至url完成支付。

BCOrder bcOrder = new BCOrder(PAY_CHANNEL.ALI_WAP, 1, billNo, title);
bcOrder.setBillTimeout(360);
bcOrder.setReturnUrl(aliReturnUrl);
try {
    bcOrder = BCPay.startBCPay(bcOrder);
    out.println(bcOrder.getObjectId());
    Thread.sleep(3000);
    out.println(bcOrder.getHtml());
} catch (BCException e) {
    log.error(e.getMessage(), e);
    out.println(e.getMessage());
}

支付宝扫码调用

返回的BCOrder对象包含表单支付html和跳转支付url,开发者提交支付表单或者跳转至url完成支付。

BCOrder bcOrder = new BCOrder(PAY_CHANNEL.ALI_QRCODE, 1, billNo, title);
bcOrder.setBillTimeout(360);
bcOrder.setReturnUrl(aliReturnUrl);
bcOrder.setQrPayMode(QR_PAY_MODE.MODE_FRONT);
try {
    bcOrder = BCPay.startBCPay(bcOrder);
    out.println(bcOrder.getObjectId());
    Thread.sleep(3000);
    out.println(bcOrder.getHtml());
} catch (BCException e) {
    log.error(e.getMessage(), e);
    out.println(e.getMessage());
}

微信扫码调用

返回的BCOrder对象包含code url,格式为：weixin://wxpay/bizpayurl?sr=XXXXX。调用第三方库将返回的code url生成二维码图片。该模式链接较短，生成的二维码打印到结账小票上的识别率较高。

BCOrder bcOrder = new BCOrder(PAY_CHANNEL.WX_NATIVE, 1, billNo, title);
bcOrder.setBillTimeout(360);
try {
    bcOrder = BCPay.startBCPay(bcOrder);
    out.println(bcOrder.getObjectId());
    out.println(bcOrder.getCodeUrl());
} catch (BCException e) {
    log.error(e.getMessage(), e);
    out.println(e.getMessage());
}