# easy-web-pay

**Repository Path**: dpwgc/easy-web-pay

## Basic Information

- **Project Name**: easy-web-pay
- **Description**: Easy-Web-Pay是一个简单的pc网页商城用户下单支付模块，开箱即用【支付宝、微信(未完成)】
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-03-26
- **Last Updated**: 2022-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, SpringBoot, MySQL, Web

## README

# Easy-Web-Pay

`Spring Boot` `MySQL`

## Easy-Web-Pay是一个简单的pc网页商城用户下单支付模块，开箱即用【支付宝、微信(未完成)】

* 支付宝支付文档：https://opendocs.alipay.com/open/028r8t?scene=22

***

## 使用说明

### 运行说明

* 配置MySQL数据库，在MySQL中导入sql文件。
* 配置resources/application.properties内的数据库与支付宝配置信息。
* 启动项目。

***

## 项目结构

* com.dpwgc.easywebpay
   * base   `通用基础模块`
      * dao `数据库模板（可自行定制订单表）`
      * mapper  `映射接口`
      * util    `工具类`
   * module    ``
      * alipay `支付宝支付模块`
         * controller  `控制器层`
         * service `服务层`
         * util    `工具类（可以在此定制支付参数）`
      * wxpay  `微信支付模块`
   
***

## 订单模板说明（自行扩展）
* com.dpwgc.easywebpay.base.dao.Order
    * long id;            //订单id
    * String subject;     //订单主题
    * long itemId;        //商品id
    * long userId;        //用户id
    * String orderNo;     //订单号（随机生成字符串）
    * double price;       //订单价格
    * String page;        //web支付页面（html字符串）
    * int	status;         //订单状态（0：未支付，1：已支付，2：已关闭，3：已删除）
    * String startTime;   //订单开始时间
    * String updateTime;  //订单最后更新时间

***

## 接口调用说明

* 先调用用户下单接口（buy），创建订单，并返回订单详细信息。
* 再调用支付页面获取接口（getPayPage），获取支付页面。
* 用户在支付页面支付订单。

***

## 支付宝pc网页支付模块接口文档

### 用户下单接口

#### 接口URL
> http://127.0.0.1:8100/ali/order/buy

#### 请求方式
> POST

#### Content-Type
> form-data

#### 请求Body参数
参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述
--- | --- | --- | --- | ---
itemId | 1 | Text | 是 | 商品id
userId | 1 | Text | 是 | 用户id
subject | 测试商品 | Text | 是 | 订单主题
price | 0.01 | Text | 是 | 价格

#### 成功响应示例
```json
{
	"code": 200,
	"msg": "下单成功",
	"data": {
		"id": 51,
		"subject": "测试商品",
		"itemId": 1,
		"userId": 1,
		"orderNo": "895642ad664a4d5ca9d14692d5a23d84",
		"price": 0.01,
		"page": "<form name=\"punchout_form\" method=\"post\" action=\"https://openapi.alipaydev.com/gateway.do?charset=UTF-8&method=alipay.trade.page.pay&sign=K3lxPJFv0%2BjY4j9ZYWDXWlNEctS%2FROXU3iq5%2FvOT38t7wgywb0Ctvdklow%2FzMyEywcOHBs83EMzCh9EWVdGAtZixzzQrmlL3mUsdaiiUhQeVQ5IIzjhxwJuzN6gyjX%2BvlzGA9KjRgLhA%2FuJgTOE2BRs1xdVFKBYfRUHRoDZSeSCQzH%2FQOOTHiQcvRhxqhAHNM4WiEKbJMozzWLQiGl%2Bgb6STh9MSjjkv7bvzsyBjBwZNWFlJZEj%2FLiCTyq%2B1xP7FSNekSakRLsydDW4VCo1c7pRh1Re1uAL9AKE3m3Okm6D4sMobbjZfnSM8G%2BbP9E11vWm3IbCwQnp2AMc25HLG6g%3D%3D&version=1.0&app_id=2021000119637395&sign_type=RSA2&timestamp=2022-03-26+14%3A16%3A24&alipay_sdk=alipay-sdk-java-dynamicVersionNo&format=json\">\n<input type=\"hidden\" name=\"biz_content\" value=\"{&quot;time_expire&quot;:&quot;2022-03-26 14:31:24 &quot;,&quot;out_trade_no&quot;:&quot;895642ad664a4d5ca9d14692d5a23d84&quot;,&quot;total_amount&quot;:0.01,&quot;subject&quot;:&quot;测试商品&quot;,&quot;product_code&quot;:&quot;FAST_INSTANT_TRADE_PAY&quot;}\">\n<input type=\"submit\" value=\"立即支付\" style=\"display:none\" >\n</form>\n<script>document.forms[0].submit();</script>",
		"status": 0,
		"startTime": "2022-03-26 14:16:24 ",
		"updateTime": "2022-03-26 14:16:24 "
	}
}
```
### 查询用户订单列表接口

#### 接口URL
> http://127.0.0.1:8100/ali/order/list

#### 请求方式
> POST

#### Content-Type
> form-data

#### 请求Body参数
参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述
--- | --- | --- | --- | ---
userId | 1 | Text | 是 | 用户id

#### 成功响应示例
```json
{
	"code": 200,
	"msg": "操作成功",
	"data": [
		{
			"id": 51,
			"subject": "测试商品",
			"itemId": 1,
			"userId": 1,
			"orderNo": "895642ad664a4d5ca9d14692d5a23d84",
			"price": 0.01,
			"page": null,
			"status": 0,
			"startTime": "2022-03-26 14:16:24",
			"updateTime": "2022-03-26 14:16:24"
		},
		{
			"id": 50,
			"subject": "测试商品",
			"itemId": 1,
			"userId": 1,
			"orderNo": "e0cb437f3d62493aa08675d747972477",
			"price": 0.01,
			"page": null,
			"status": 3,
			"startTime": "2022-03-26 14:00:47",
			"updateTime": "2022-03-26 14:00:47"
		},
		{
			"id": 49,
			"subject": "测试商品",
			"itemId": 1,
			"userId": 1,
			"orderNo": "a57ab17b89ef4bffbe9492ec579b9ec6",
			"price": 0.01,
			"page": null,
			"status": 3,
			"startTime": "2022-03-26 13:54:58",
			"updateTime": "2022-03-26 13:54:58"
		}
	]
}
```

### 根据订单id获取订单web支付页面（浏览器直接访问链接）

#### 接口URL
> http://127.0.0.1:8100/ali/order/getPayPage/html?orderId=1

#### 请求方式
> GET

#### 请求Query参数
参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述
--- | --- | --- | --- | ---
orderId | 1 | Text | 是 | 订单id

***

## 微信pc网页支付模块接口