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

<dependency>   
    <groupId>cn.beecloud</groupId>
    <artifactId>beecloud-java-sdk</artifactId>
    <version>3.5.1</version>
    <exclusions>  //删除beecloud java sdk依赖的包
         <exclusion>  
             <groupId>org.hibernate</groupId>  
             <artifactId>hibernate-validator</artifactId>  
         </exclusion>  
     </exclusions>  
</dependency>

<dependency>   //加上项目想要的jar包
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>5.2.4.Final</version>
</dependency>

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 bcOrder = new  BCOrder(PAY_CHANNEL.BC_ALI_SCAN, 1, billNo, title);                  bcOrder.setAuthCode("xxxxxxxx");  
try {
    bcOrder = BCPay.startBCOfflinePay(bcOrder);
    out.println(bcOrder.getObjectId());
    out.println(bcOrder.isResult());
} catch (BCException e) {
    log.error(e.getMessage(), e);
    out.println(e.getMessage());
}

TransferParameter param = new TransferParameter();
param.setChannel(TRANSFER_CHANNEL.ALI_TRANSFER);
param.setChannelUserId(aliUserId);
param.setChannelUserName(aliUserName);
param.setTotalFee(1);
param.setDescription("支付宝单笔打款！");
param.setAccountName("苏州比可网络科技有限公司");
param.setTransferNo(aliTransferNo);
try {
    String url = BCPay.startTransfer(param);
    response.sendRedirect(url);
} catch (BCException e) {
    log.error(e.getMessage(), e);
    out.println(e.getMessage());
}

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());
 }

BeeCloud.registerApp("appid", "", "appSecret", "masterSecret");
BCBillConfirm confirm=new BCBillConfirm("支付返回的token","支付返回的id","手机短信验证码");
Map<String, Object> map= BCPay.billConfirm(confirm);
System.out.print(map.toString());```

代码中的BCBillConfirm封装字段含义如下：

key | 说明
---- | -----
token | 支付返回的token（必填）
billId | 支付返回的订单id（必填）
verifyCode | 短信验证码（必填）    


### <a name="refund">退款</a>

退款接口接收BCRefund参数对象，该对象封装了发起退款所需的各个具体参数。  

成功发起退款接口将会返回带objectId的BCRefund对象。
退款接口分为直接退款和预退款功能，当BCRefund的**needApproval**属性设置为**true**时，开启预退款功能，当BCRefund的**needApproval**属性为**空**或者**false**, 开启直接退款功能，并在channel为ALI时返回带支付宝退款跳转url的BCRefund对象, 开发者跳转至url输入支付密码完成退款。

BC_GATEWAY暂不支持预退款。

发起退款异常情况将抛出BCException, 开发者需要捕获此异常进行相应失败操作 开发者可根据异常消息判断异常的具体信息，异常信息的格式为<mark>"resultCode:xxx;resultMsg:xxx;errDetail:xxx(;responseCode:xxx)"</mark>。

```java
BCRefund refund = new BCRefund(billNo, refundNo, 1);
try {
    BCRefund refund = BCPay.startBCRefund(refund);
    if (refund.getAliRefundUrl() != null) {//直接退款（支付宝）
        response.sendRedirect(refund.getAliRefundUrl());
    } else {
    	if (refund.isNeedApproval() != null && refund.isNeedApproval()) {//预退款
    		out.println("预退款成功！");
    		out.println(refund.getObjectId());
    	} else {//直接退款
        	out.println("退款成功！易宝、百度、快钱渠道还需要定期查询退款结果！");
        	out.println(refund.getObjectId());
    	}
    }
} catch (BCException e) {
    out.println(e.getMessage());
    e.printStackTrace();
}

BCBatchRefund batchRefundAgree = new BCBatchRefund();
batchRefundAgree.setIds(Arrays.asList(ids));
batchRefundAgree.setChannel(channel);
batchRefundAgree.setAgree(true);//批量同意
try {
	BCBatchRefund result = BCPay.startBatchRefund(batchRefundAgree);
	out.println("<div>");
    for (String key : result.getIdResult().keySet()) {
        String info = result.getIdResult().get(key);
        out.println(key + ":" + info + "<br/>");
    }
    if (channel.equals(PAY_CHANNEL.ALI))
        response.sendRedirect(result.getAliRefundUrl());
} catch(BCException ex) {
	ex.printStackTrace();
    out.println(ex.getMessage());
}

BCBatchRefund batchRefundDeny = new BCBatchRefund();
batchRefundDeny.setIds(Arrays.asList(ids));
batchRefundDeny.setChannel(channel);
batchRefundDeny.setAgree(false);//批量否决
try {
	BCBatchRefund result = BCPay.startBatchRefund(batchRefundDeny);
    out.println("<h3>批量驳回成功!</h3>");
} catch(BCException ex) {
	ex.printStackTrace();
    out.println(ex.getMessage());
}

BCQueryParameter param = new BCQueryParameter();
param.setNeedDetail(true);//设置返回messgeDetail
param.setChannel(channel);//设置查询条件channel
try {
    List<BCOrder> bcOrders = BCPay.startQueryBill(param);
    System.out.println("billSize:" + bcOrders.size());
} catch (BCException e) {
    out.println(e.getMessage());
}

BCQueryParameter param = new BCQueryParameter();
try {
    int count = BCPay.startQueryBillCount(param);
    pageContext.setAttribute("count", count);
} catch (BCException e) {
    out.println(e.getMessage());
}

try {
    BCOrder result = BCPay.startQueryBillById(id);
    pageContext.setAttribute("bill", result);
} catch (BCException e) {
    out.println(e.getMessage());
}

BCQueryParameter param = new BCQueryParameter();
param.setChannel(channel);
param.setNeedDetail(true);
try {
    List<BCRefund> bcRefunds = BCPay.startQueryRefund(param);
    pageContext.setAttribute("refundList", bcRefunds);
    System.out.println("refundList:" + bcRefunds.size());
} catch (BCException e) {
    e.printStackTrace();
    out.println(e.getMessage());
}

BCQueryParameter param = new BCQueryParameter();
try {
    int count = BCPay.startQueryRefundCount(param);
    pageContext.setAttribute("count", count);
} catch (BCException e) {
    out.println(e.getMessage());
}

try {
    BCRefund result = BCPay.startQueryRefundById(id);
    pageContext.setAttribute("refund", result);
} catch (BCException e) {
    out.println(e.getMessage());
}

try {
    String result = BCPay.startRefundUpdate(channel, refund_no);
    out.println(result);
} catch(BCException ex) {
	out.println(ex.getMessage());
	log.info(ex.getMessage());
}

BCTransferParameter param = new BCTransferParameter();
param.setBillNo("1111111111");//设置订单号 8到32位数字和/或字母组合，请自行确保在商户系统中唯一，同一订单号不可重复提交，否则会造成订单重复
param.setTitle("subject");//设置标题 UTF8编码格式，32个字节内，最长支持16个汉字
param.setTotalFee(1);//设置下发订单总金额 必须是正整数，单位为分
param.setTradeSource("OUT_PC");//UTF8编码格式，目前只能填写OUT_PC
param.setBankFullName("中国银行");//银行全称，不能缩写
param.setCardType("DE");//卡类型 DE代表借记卡，CR代表信用卡，其他值为非法
param.setAccountType("P");//账户类型 区分对公和对私 P代表私户，C代表公户，其他值为非法
param.setAccountNo("123456789");//收款方的银行卡号
param.setAccountName("beecloud");//收款方的姓名或者单位名
try {
	BCPay.startBCTransfer(param);
}catch (Exception e) {
	out.println(ex.getMessage());
	log.info(ex.getMessage());
}		

	try {
	    List<String> banks = BCPay.fetchBCTransfersBanks(BC_TRANSFER_BANK_TYPE.P_CR);
	    out.println(banks.toString());
	} catch (BCException e) {
	    out.println(e.getMessage());
	}		

    String name = "冯晓波";
	String idNo = "320504192306171022";
	String cardNo = "6114335124826228";
	String mobile = "13761231321";
	BCAuth auth = new BCAuth(name, idNo, cardNo);
	auth.setMobile(mobile);
	
	try {
		auth = BCPay.startBCAuth(auth);
		out.println("鉴权成功！");
		out.println(auth.getAuthMsg());
		out.println(auth.getCardId());
		out.println(auth.isAuthResult());

	} catch (BCException e) {
			out.println(e.getMessage());
	}

    try {
        String smsId = BCSubscriptionPay.sendSMS("13861331391");
        out.println(smsId);//保留此smsId以便后续发起订阅使用
    } catch (BCException ex){
        out.print(ex.getMessage());
    }

try {
    /**
     * 以下是通过银行5要素订阅的demo
     */
    BCSubscription subscription = new BCSubscription();
    subscription.setPlanId("4a009b37-c36a-49d3-b011-d13d43535b96");
    subscription.setBuyerId("demo buyer id");
    subscription.setSmsId(smsId);//验证码发送接口返回的smsId
    subscription.setSmsCode("code of your mobile received");//收到的短信验证码
    subscription.setMobile("13661331392");
    subscription.setBankName("交通银行");
    subscription.setCardNo("6222630140019836463");
    subscription.setIdName("冯小刚");
    subscription.setIdNo("350503198606271013");
    BCSubscription result = BCSubscriptionPay.startSubscription(subscription);
    out.println(result.getCardId());//保留待直接通过cardId发起订阅
    out.println(result.getValid());
    out.println(result.getStatus());
    out.println(result.getObject());//保留待取消订阅时使用

    } catch (BCException ex){
        out.print(ex.getMessage());
    }
    
    /**
     * 以下是直接通过cardId订阅的demo
     */
    BCSubscription subscription = new BCSubscription();
    subscription.setCardId("第一次成功订阅后通过webhook获得");
    subscription.setSmsId(smsId);//验证码发送接口返回的smsId
    subscription.setSmsCode("code of your mobile received");//收到的短
    BCSubscription result = BCSubscriptionPay.startSubscription(subscription);
    out.print(result.getStatus());

String id;
BCSubscription subscription = new BCSubscription();
subscription.setObjectId("2ae989af-9cfd-4004-b350-5b4e1cad4d0a");
try {
    id = BCSubscriptionPay.cancelSubscription(subscription);
    out.print(id);
} catch (BCException e) {
    e.printStackTrace();
}

BCSubscriptionQueryParameter param = new BCSubscriptionQueryParameter();
param.setPlanId("xxxxxxxxxxxxx");
try {
    Object result = BCSubscriptionPay.fetchSubsciptionByCondition(param);
    if (result instanceof List) {
        List<BCSubscription> subscriptions = (List<BCSubscription>)result;
    } else {
        out.print(result);
    }
} catch (BCException ex) {
    ex.printStackTrace();
    out.println(ex.getMessage());
}

BCPlanQueryParameter param = new BCPlanQueryParameter();
param.setNameWithSubstring("订阅");
try {
    Object result = BCSubscriptionPay.fetchPlanByCondition(param);
    if (result instanceof List) {
        List<BCPlan> plans = (List<BCPlan>)result;
    } else {
        out.print(result);
    }
} catch (BCException ex) {
    ex.printStackTrace();
    out.println(ex.getMessage());
}

try {
    SubscriptionBanks banks = BCSubscriptionPay.fetchSubscrptionBanks();
    out.println("banks:" + banks.getBankList().toString());
    out.println("<br/><br/>");
    out.println("common_banks:" + banks.getCommonBankList().toString());
} catch (BCException ex) {
    ex.printStackTrace();
    out.println(ex.getMessage());
}