## **乐刷合作方JAVA-SDK使用指南** ## ### **注意事项** ### - 提供的SDK仅供参考，不能直接到生产环境中使用。 **运行环境** - Jdk1.7、Maven3.2.5、Eclipse Luna4.4.2、Tomcat8.0、编码UTF-8 **相关约定** - 商户号 乐刷分配的商户ID - 商户密钥 商户对应的密钥（签名使用） - 代理商密钥 代理商对应的密钥（签名使用） - 第三方订单号（第三方系统生成的订单号） **注**： 请求地址、agentId、privateKey等信息配置在config.properties文件中，更改信息时直接更改配置文件即可。配置文件config.properties在leshua-demo和leshua-sdk中都有，如果只引用leshua-sdk-0.0.1-SNAPSHOT.jar则以leshua-sdk中的配置文件为准，如果运行leshua-demo，以leshua-demo中的配置文件为准。 **SAAS渠道商商户接入接口调用DEMO** 主要结构：Leshua-demo工程对进件接口和交易接口中的接口都做了调用实例，可以直接部署工程进行测试，工程结构使用的是简单的MVC模型结构,leshua-demo使用maven引用leshua-sdk。  - **下面以进件接口中“商户信息查询”接口为例，描述demo、sdk开发步骤**： 1、在HomeController、index.jsp中加上相应的请求方法及对应跳转页面 ``` /**HomeController * 商户信息查询 * @return */ @RequestMapping("/wxOrZfbReportQuery") public String wxOrZfbReportQuery(){ return "wxOrZfbReportQuery"; } <!--index.jsp> <dl class="menu"> <dt>商户信息查询：</dt> <dd> <a href=" wxOrZfbReportQuery">点此</a> </dd> <dl> ``` 2、 编写对应的jsp页面，jsp名与HomeController中return的字符串值一致  3、在MerchantController(leshua-demo)、MerchantGateWayService(leshua-sdk)中添加对应的方法： ``` /**  * 商户信息查询  * @param request  * @param model  * @return  */ @RequestMapping("/wxOrZfbReportQuery") public String wxOrZfbReportQuery(HttpServletRequest request,Model model){ JSONObject data = new JSONObject(); String result = null; try{ validParam(data, "merchantId", request.getParameter("merchantId")); validParam(data, "reportConfigId",request.getParameter("reportConfigId")); result = service.wxOrZfbReportQuery(data); }catch(Exception e) { logger.info("商户信息查询",e); } return result; } ```  4、在MerchantConfig中新增对应的配置变量 ``` public class MerchantConfig {      public static String AGENT_ID;//代理商编号      public static String KEY;//私钥      public static String VERSION; //版本号      public static String CHARSET;//字符编码//   public static String REQ_SERIAL_NO = UUID.randomUUID().toString();//请求流水号，可自定义       public static String REGISTER_URL;//商户进件      public static String OPEN_URL;//商户开通业务     public static String UPDATE_URL;//商户信息修改     public static String WX_PAY_CONFIG_URL;//商户支付参数-新增      public static String WX_PAY_CONFIG_QUERY_URL;//商户支付参数-查询 public static String WX_ZFB_MCH_INFO_QUERY_URL;//商户信息查询          public static String ACCOUNT_UPDATE_URL;//结算卡快速修改 static {          Properties prop = new Properties();         InputStream in = LeshuaConfig.class.getResourceAsStream("/config.properties");          try { prop.load(in);              AGENT_ID = prop.getProperty("AGENT_ID").trim();   KEY = prop.getProperty("KEY").trim(); VERSION = prop.getProperty("VERSION").trim();              CHARSET = prop.getProperty("CHARSET").trim();                REGISTER_URL = prop.getProperty("REGISTER_URL").trim();   OPEN_URL = prop.getProperty("OPEN_URL").trim();   UPDATE_URL = prop.getProperty("UPDATE_URL").trim();              WX_PAY_CONFIG_URL=prop.getProperty("WX_PAY_CONFIG_URL").trim();     WX_PAY_CONFIG_QUERY_URL =prop.getProperty("WX_PAY_CONFIG_QUERY_URL").trim();             WX_ZFB_MCH_INFO_QUERY_URL=prop.getProperty("WX_ZFB_MCH_INFO_QUERY_URL").trim();              ACCOUNT_UPDATE_URL=prop.getProperty("ACCOUNT_UPDATE_URL").trim();              SETTLEMENT_ORDER_URL = prop.getProperty("SETTLEMENT_ORDER_URL").trim();          } catch (IOException e){     e.printStackTrace();         }    } ``` 5、在config.properties中添加对应的配置 ``` #商户信息查询 WX_ZFB_MCH_INFO_QUERY_URL=http://pos.lepass.cn/api/merchant/mch_info_qry.do ``` - **下面以交易接口为例，描述demo、sdk开发步骤** - **项目结构**  - **引用JAR包** leshua-sdk-0.0.1-SNAPSHOT.jar - **相关SERVICE** LeshuaMicroPayService : 条码支付 LeshuaScanCodePayService: 扫码支付 LeshuaTransQueryService: 交易查询 LeshuaTransRefundService: 交易退款 LeshuaRefundQueryService: 交易退款查询 LeshuaOrderCloseService: 交易订单关闭 LeshuaOpenIdQueryService: 授权码查询用户openid **注** : SDK内部封装了接口签名及验签功能，只需要调用相应的service,即可调通所有接口，相应接口参数，请查看接口文档。具体调用参考leshua-demo - **调用代码片段** 1、扫码支付  2、条码支付  3、交易结果查询  4、订单关闭  5、退款  6、退款查询  7、授权码查询用户openid  8、回调通知(POST接收XML参数)