# MerchantDemo

**Repository Path**: wbmx/MerchantDemo_V1.1

## Basic Information

- **Project Name**: MerchantDemo
- **Description**: thirdpayV2模拟商户业务系统（开发测试用）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-26
- **Last Updated**: 2026-01-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

								　      ─────────────────────────────────────────     
								           产品名称：  网站支付挂件
								      JDK：  本示例JDK版本基于jdk1.7版本建议使用jdk1.7.0_80
								                   日期：  2016-06-20
								    ─────────────────────────────────────────
───────────
 **重要**
1） 联调前请仔细阅读以下说明，并明确Demo的结构，按照最后的接入说明来进行接入
2） 此工程可以跑起来测试，建议使用chrome、火狐打开
───────────


───────────
示例工程目录结构(SpringMVC+Spring+Maven)
───────────

MerchantDemo  
  │
  ├src/main/java┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈类文件夹
  │  │
  │  com.zxpay.demo ┈┈┈┈┈┈┈┈┈相关资源目录
  │  │  │
  │  │  ├controller
  │  │  │   ├WidgetController.java┈┈┈┈┈┈┈┈┈ 【重要】创建chargeString，前台通知，后台通知的Controller示例方法都在这个类中  
  │  │  │   │
  │  │  │   ├AuthPayController.java┈┈┈┈┈┈┈┈┈ 支付宝条码支付测试controller  
  │	 │  │   │
  │  │  │	└KaptchaController.java ┈┈┈┈┈┈┈┈┈ 登录index页面中生成验证码的controller  
  │  │  │  
  │  │  ├domain 
  │  │  │   │
  │  │  │   ├EPayBook.java  ┈┈┈┈┈┈┈┈┈缴款书实体类
  │  │  │   │
  │  │  │   └EPayBookItem.java ┈┈┈┈┈┈┈┈┈每个缴款项的实体类
  │	 │  │
  │  │  ├service
  │  │  │   │
  │  │  │   └PayBookService.java┈┈┈┈┈┈┈┈┈生成缴款书的service
  │  │  │  
  │  │  └util
  │  │      │
  │  │      ├MoneyUtils.java┈┈┈┈┈┈┈┈┈Money工具类
  │  │      │
  │  │      └ParamConstant.java ┈┈┈┈┈┈┈┈┈【重要】参数常量类，需要商户传递的参数都配置在该常量类中
  │  │  
  │  ├com.bosssoft.sdk
  │	 │  │
  │  │  ├net
  │  │  │ │
  │  │  │ APIResource.java┈┈┈┈┈┈┈┈┈ 【重要】所有核心的与挂件服务端交互的方法都在该类中
  │	 │  │ │
  │  │  │ └ThirdpayResponse.java  
  │  │  │
  │  │  ├model（该目录下都是用到的相关model）
  │  │  │  
  │  │  ├thirdpay
  │  │  │   │
  │  │  │   └ThirdPay.java
  │	 │  │
  │  │  ├dto
  │  │  │   │
  │  │  │   └ThirdpayDataDto.java┈┈┈┈┈┈┈┈┈该类中存放获取私钥的方法，商户可根据自己的业务将私钥引入自己的工程中
  │  │  │  
  │  │  └util
  │  │      │
  │  │      ├Base64Utils.java┈┈┈┈┈┈┈┈┈Base64工具类
  │  │      │
  │  │      ├RSAMethod.java ┈┈┈┈┈┈┈┈┈RSA工具类
  │	 │      │
  │  │   	└ThirdpaySignature.java┈┈┈┈┈┈┈┈┈签名工具类
  │  │  
  │  │
  │  └web ┈┈┈┈┈┈┈┈┈ web相关类
  │         
  │      
  │
  ├src/main/resources┈┈┈┈┈┈┈┈┈配置文件目录
  │  │  
  │  ├log4j.properties ┈┈┈┈┈┈┈┈┈log4j日志的配置文件  
  │  │
  │  ├spring.xml ┈┈┈┈┈┈┈┈┈┈┈spring配置文件
  │  │
  │  └spring-mvc.xml┈┈┈┈┈┈┈┈┈┈┈spring-mvc配置文件
  │   	  	     
  │   	     
  │
  ├src ┈┈┈┈┈┈┈页面文件夹
  │  │
  │  ├help文件夹 ┈┈┈┈┈┈┈┈┈为了Demo完整设置的帮助链接页面
  │  │  
  │  ├resources文件夹 ┈┈┈┈┈┈┈┈┈Demo所需要的css样式、js、图片等
  │  │
  │  └WEB-INF/view/jsp/
  │				 ├include(该目录下是Demo运行时所需要的包含的页面)
  │              │
  │				 ├authpay(该目录下是支付宝条码付相关页面，接入网站支付挂件可以不用参考)
  │              │
  │              ├index.jsp（Demo入口页面）
  │   	         │
  │   	         ├charge.jsp【重要】生成挂件的示例页面，包括如何引用js，和传参数的示例
  │   	         │
  │   	         ├success.jsp（前端回调通知跳转的成功页面）
  │   	         │
  │   	         └help.jsp（帮助页面）   	              	     
  │   	     
  │
  └readme.txt ┈┈┈┈┈┈┈┈┈使用说明文本

 ****注意****

1.【关于商户号】
      开发包中使用的商户号2102002017061601是测试商户号，只能在测试环境使用；
      可以先使用这个商户号来调通、显示挂件
      正式线上环境请替换成申请的正式商户号。
2.【关于证书问题】测试环境使用的签名私钥证书，验签公钥证书均在挂件服务端中已经生成配置好，用户测试成功后，正式上线环境时申请替换成正式环境商户的私钥、公钥。

3.接入说明：
 (1)、首先应该将com.bosssoft.sdk.*下的所有内容引到商户自己的工程中。
 (2)、在要显示挂件的页面上根据接口文档2.1，参照Demo的charge.jsp页面来引用服务器上面的js，并传入参数
 (3)、参照WidgetController中的createCharge方法来创建charge的String字符串形式，并跳转支付页面（具体字段参考接口文档2.2）
 (4)、前台通知参照WidgetController中的frontNotice方法，后台通知参照MerchantController中的backNotice方法（具体字段参考接口文档2.5，2.6）