📝 编写文档

packages/docs/docs/.vuepress/config.js

@@ -40,7 +40,7 @@ module.exports = ctx => ( {
                 sidebar: {
                     '/guide/': getGuideSidebar('客户端','微信系开发脚手架',
                         'IJPay 让支付触手可及','获取支付配置','支付宝支付','微信支付',
-                        'QQ 钱包支付','银联支付','京东支付','赞助','插件工具'),
+                        'QQ 钱包支付','银联支付','京东支付','PayPal 支付','赞助','插件工具'),
                 },
             },
             // '/en/': {
@@ -86,8 +86,15 @@ module.exports = ctx => ( {
     ]
 })
 
-function getGuideSidebar (groupA, groupB,groupC,groupD,groupE,groupF,groupG,groupH,groupI,groupK,groupL) {
+function getGuideSidebar (groupA, groupB,groupC,groupD,groupE,groupF,groupG,groupH,groupI,groupJ,groupK,groupL) {
     return [
+        {
+            title: groupL,
+            collapsable: false,
+            children: [
+                'tools/frp/',
+            ]
+        },
         {
             title: groupA,
             collapsable: false,
@@ -163,19 +170,20 @@ function getGuideSidebar (groupA, groupB,groupC,groupD,groupE,groupF,groupG,grou
             ]
         },
         {
-            title: groupK,
+            title: groupJ,
             collapsable: false,
             children: [
-                'donate/',
+                'paypal/',
             ]
         },
         {
-            title: groupL,
+            title: groupK,
             collapsable: false,
             children: [
-                'tools/frp/',
+                'donate/',
             ]
         },
+
     ]
 }
 

packages/docs/docs/guide/maven.md

@@ -84,7 +84,22 @@ QQ 支付
     <artifactId>IJPay-UnionPay</artifactId>
     <version>latest-version</version>
 </dependency>
-```       
+```  
+
+
+::: tip
+PayPal 支付
+:::
+
+在项目的 pom.xml 的 dependencies 中加入以下内容:
+
+```xml
+<dependency>
+    <groupId>com.github.javen205</groupId>
+    <artifactId>IJPay-PayPal</artifactId>
+    <version>latest-version</version>
+</dependency>
+```     
 
 ## 更多依赖方式
 

packages/docs/docs/guide/paypal/README.md

+# IJPay 中的 PayPal 支付
+
+## 官方参考文档
+
+- [创建沙箱应用与账号](https://developer.paypal.com/docs/api/overview/#create-sandbox-accounts)
+- [获取 AccessToken](https://developer.paypal.com/docs/api/overview/#get-an-access-token)
+
+
+## 添加模块依赖
+
+[添加模块依赖](../maven.md)
+
+## 配置说明 
+
+::: tip IJPay 中 PayPal 支付需要配置的参数如下：
+- clientId: 应用编号
+- secret: 应用密钥 
+- sandBox: 是否是沙箱环境
+- domain: 外网访问项目的域名，回调中会使用
+:::
+
+## 实例化配置
+
+```java {}
+public PayPalApiConfig getConfig() {
+    PayPalApiConfig config = new PayPalApiConfig();
+    config.setClientId(payPalBean.getClientId());
+    config.setClientSecret(payPalBean.getSecret());
+    config.setSandBox(payPalBean.getSandBox());
+    config.setDomain(payPalBean.getDomain());
+    PayPalApiConfigKit.setThreadLocalApiConfig(config);
+    return config;
+}
+```
+## 获取 AccessToken 
+
+::: tip 默认获取 AccessToken 策略如下:
+- 如获取失败将会重试，三次失败后将返回空
+- 默认使用 Map 保存在内存中
+:::
+
+### 修改缓存策略
+
+```java {}
+AccessTokenKit.setCache(new IAccessTokenCache() {
+    @Override
+    public String get(String key) {
+        return null;
+    }
+
+    @Override
+    public void set(String key, String jsonValue) {
+
+    }
+
+    @Override
+    public void remove(String key) {
+
+    }
+});
+```
+
+### 强制刷新与缓存 
+
+```java {}  
+// 从当前线程中获取应用配置并获取 AccessToken
+AccessToken accessToken = AccessTokenKit.get(); 
+// 从当前线程中获取应用配置并强制刷新 AccessToken
+AccessToken accessToken = AccessTokenKit.get(true);
+// 通过应用编号获取应用配置并获取 AccessToken
+AccessToken accessToken = AccessTokenKit.get(config.getClientId());
+// 通过应用编号获取应用配置并强制刷新 AccessToken 
+AccessToken accessToken = AccessTokenKit.get(config.getClientId(),true); 
+```
+
+## 如何使用？
+
+请参考 [JavaDoc 文档](https://apidoc.gitee.com/javen205/IJPay)或者看以下完整示例
+
+## 完整示例
+ 
+- [IJPay-Demo-SpringBoot](https://gitee.com/javen205/IJPay/tree/master/IJPay-Demo-SpringBoot)
+
+
+