Linuxword Global
当前位置: 建站相关 > 最新V2board面板支付设置|支付对接,V2Board 最全接口文档(1.6.0)

d2b5ca33bd134032-1024x555-1

宝塔安装v2b

环境要求:自行百度安装,或通过宝塔安装,Nginx,MySQL 5.6,PHP 7.4

需额外安装两个扩展:

 
  1. Redis、fileinfo

解除PHP函数限制,需解除四个禁用函数:

 
  1. putenv、proc_open、pcntl_alarm、pcntl_signal

创建网站目录并删除目录下自动生成的所有文件

在ssh进入网站目录

 
  1. cd /www/wwwroot/网站目录/

克隆V2Board项目:

 
  1. git clone https://github.com/v2board/v2board.git ./

依赖下载:

 
  1. wget https://getcomposer.org/download/1.9.0/composer.phar
  2. php composer.phar config repo.packagist composer https://mirrors.aliyun.com/composer/
  3. php composer.phar install

安装V2Board面板:

 
  1. php artisan v2board:install

配置站点目录及伪静态

设置站点运行目录为

 
  1. /public

设置站点伪静态

 
  1. location /downloads {
  2. }
  3.  
  4. location / {
  5. try_files $uri $uri/ /index.php$is_args$query_string;
  6. }
  7.  
  8. location ~ .*\.(js|css)?$
  9. {
  10. expires 1h;
  11. error_log off;
  12. access_log /dev/null;
  13. }

配置计划任务和启动队列服务

计划任务

 
  1. (Cron) -> Shell脚本

1分钟运行一次:

 
  1. php /www/wwwroot/网站目录/artisan schedule:run

软件商店 -> Supervisor管理器

运行用户:

 
  1. www

运行目录:

 
  1. /www/wwwroot/网站/

命令:

 
  1. php artisan horizon

网站目录权限重新设置755

致此宝塔安装V2Board完毕

主题

附件下载里提供一个Bob-Theme-Argon主题(文章图片的主题)

解压到

 
  1. /public/theme/目录下

如果Gravatar头像经常加载不出来,可以更换地址

路径为

 
  1. /app/Http/Controllers/User/UserController.php

替换为

 
  1. https://sdn.geekzu.org/avatar/

节点安装

一键安装 更新

 
  1. bash <(curl -Ls https://raw.githubusercontent.com/XrayR-project/XrayR-release/master/install.sh)

将域名托管到cloudflared

同步时间(重要)

v2ray 节点需要进行时间同步,时间若与客户端相差太大则无法连接

CentOS 7

 
  1. yum install -y ntp
  2. systemctl enable ntpd
  3. ntpdate -q 0.rhel.pool.ntp.org
  4. systemctl restart ntpd

第一步,在面板添加一个节点

 
  1. 后台 >节点管理 >添加节点
  2. 节点名称:随便填什么
  3. 权限组:随便填什么
  4. 节点地址:填cf的ip或者伪装的域名
  5. TLS:伪装的域名
  6. 端口:443
  7. 传输协议:选择websocket
  8. 配置协议:
  9. {
  10. "path": "/随便",
  11. "headers": {
  12. "Host": "伪装的域名"
  13. }
  14. }

第二步,配置 XrayR

第一次安装完成后,编辑配置文件:

配置文件位置在

 
  1. /etc/XrayR/config.yml

基础配置

 
  1. Log:
  2. Level: warning # Log level: none, error, warning, info, debug
  3. AccessPath: # /etc/XrayR/access.Log
  4. ErrorPath: # /etc/XrayR/error.log
  5. DnsConfigPath: # /etc/XrayR/dns.json # Path to dns config, check https://xtls.github.io/config/dns.html for help
  6. RouteConfigPath: #/etc/XrayR/route.json # Path to route config, check https://xtls.github.io/config/routing.html for help
  7. InboundConfigPath: #/etc/XrayR/custom_inbound.json # Path to custom inbound config, check https://xtls.github.io/config/inbound.html for help
  8. OutboundConfigPath: #/etc/XrayR/custom_outbound.json # Path to custom outbound config, check https://xtls.github.io/config/outbound.html for help
  9. ConnectionConfig:
  10. Handshake: 4 # Handshake time limit, Second
  11. ConnIdle: 30 # Connection idle time limit, Second
  12. UplinkOnly: 2 # Time limit when the connection downstream is closed, Second
  13. DownlinkOnly: 4 # Time limit when the connection is closed after the uplink is closed, Second
  14. BufferSize: 64 # The internal cache size of each connection, kB
  15. Nodes:
  16.  
  17. -
  18. PanelType: "NewV2board" ## 对接的面板类型: SSpanel, V2board, NewV2board, PMpanel, Proxypanel, V2RaySocks
  19. ApiConfig:
  20. ApiHost: "https://****.com" ## 面板域名地址,或自定义个专用后端对接不提供访问的域名
  21. ApiKey: "*****" ## 面板设置的通讯密钥
  22. NodeID: 1 ## 前端节点id
  23. NodeType: V2ray ## 对接的节点类型:可选V2ray, Shadowsocks, Trojan
  24. Timeout: 30 # Timeout for the api request
  25. EnableVless: false # Enable Vless for V2ray Type
  26. EnableXTLS: false # Enable XTLS for V2ray and Trojan
  27. SpeedLimit: 0 # Mbps, Local settings will replace remote settings
  28. DeviceLimit: 0 # Local settings will replace remote settings
  29. ControllerConfig:
  30. ListenIP: 0.0.0.0 # IP address you want to listen
  31. UpdatePeriodic: 100 # Time to update the nodeinfo, how many sec.
  32.  
  33. CertConfig:
  34. CertMode: dns # Option about how to get certificate: none, file, http, dns. Choose "none" will forcedly disable the tls config.
  35. CertDomain: "***.com" # 伪装的域名
  36. Provider: cloudflare # DNS cert provider, Get the full support list here: https://go-acme.github.io/lego/dns/
  37. Email: test@me.com
  38. DNSEnv: # DNS ENV option used by DNS provider
  39. CLOUDFLARE_EMAIL: test@me.com ##CF登录邮箱
  40. CLOUDFLARE_API_KEY: 57b4d8ec82ec3e ##CF全局api

第三步启动 XrayR

 
  1. xrayr start

系统级操作

centos打开端口的方法

关闭防火墙(重启后永久生效):

 
  1. chkconfig iptables off

使用以下命令可以禁用CentOS的防火墙:

 
  1. systemctl disable firewalld

打开某个端口(以443为例)

开启端口

 
  1. iptables -A INPUT -p tcp --dport 443 -j ACCEPT

保存并重启防火墙

 
  1. /etc/rc.d/init.d/iptables save
  2. /etc/init.d/iptables restart

打开49152~65534之间的端口

 
  1. iptables -A INPUT -p tcp --dport 49152:65534 -j ACCEPT
  2. 同样,这里需要对设置进行保存,并重启防火墙。

致此所有步骤均已完成。
最后说一下,这里有很多的坑,要自己慢慢的去体会。原谅我这种东西不能出视频教程。

正所谓师傅领进门,修行在个人。加油!

感谢 v2board 提供的开源项目! 完整api请查阅开源项目 : v2board

本文档仅适用于1.6.0版本,1.6.1由于改动过大会等稳定后专门提出来写

目录

Passport

URL 请求 描述
/passport/comm/config GET 获取配置
/passport/auth/check GET 登入校验
/passport/auth/login POST 登入账号
/passport/comm/sendEmailVerify POST 发送邮箱验证码
/passport/auth/register POST 注册账号
/passport/auth/forget POST 重置密码

User

URL 请求 描述
/user/logout GET 登出
/user/info GET 账号信息
/user/getSubscribe GET 订阅信息
/user/resetSecurity GET 重置订阅链接
/user/getStat GET 代办事项
/user/changePassword POST 修改密码
/user/update POST 通知状态
/user/transfer POST 佣金划转

Plan

URL 请求 描述
/user/plan/fetch GET 订阅商店列表

Order

URL 请求 描述
/user/order/fetch GET 订单列表
/user/order/getPaymentMethod GET 支付方式
/user/order/details?trade_no= GET 订单详情
/user/order/check?trade_no= GET 订单状态
/user/order/save POST 创建订单
/user/order/checkout POST 结算订单
/user/order/cancel POST 关闭订单

Invite

URL 请求 描述
/user/invite/fetch GET 邀请码管理
/user/invite/save GET 生成邀请码
/user/invite/details GET 邀请明细

Notice

URL 请求 描述
/user/notice/fetch GET 公告信息

Ticket

gugugu...


Passport

1.获取配置

GET /passport/comm/config

  • 请求参数 null

  • 成功返回示例 json

{
  "data": {
    "tos_url": "https://xxx.com",
    "is_email_verify": 0,
    "is_invite_force": 0,
    "email_whitelist_suffix": 0,
    "is_recaptcha": 0,
    "recaptcha_site_key": "xxx",
    "app_description": "Hallo!",
    "app_url": "https://xxx.com"
  }
}
 
参数名 类型 描述
tos_url string 条款链接
is_email_verify number 邮件验证
is_invite_force number 强制邀请注册
email_whitelist_suffix number or string[] 邮件白名单后缀
is_recaptcha number 人机验证
recaptcha_site_key string 人机验证校验码
app_description string 站点说明
app_url string 站点地址

2.登入校验

GET /passport/auth/check

  • 请求参数 null

  • 成功返回示例 json

{
  "data": {
    "is_login": false
  }
}
 
参数名 类型 描述
is_login boolean 是否登入

3.登入账号

POST /passport/auth/login

  • 请求参数 json
 {
  "email": "xxxx@xx.com",
  "password": "1234567890"
}
 
参数名 类型 必填 描述
email string ✔︎ 邮箱地址
password string ✔︎ 密码
  • 成功返回示例 json
{
  "data": {
    "token": "xxx",
    "auth_data": "xxx"
  }
}
 
参数名 类型 描述
token string 用户 token
auth_data string base64(邮箱:密码)

4.发送邮箱验证码

POST /passport/comm/sendEmailVerify

  • 请求参数 json
 {
  "email": "xxxx@xx.com"
}
 
参数名 类型 必填 描述
email string ✔︎ 邮箱地址
  • 成功返回示例 json
{
  "data": true
}
 
参数名 类型 描述
data boolean 是否发送成功

5.注册账号

POST /passport/auth/register

  • 请求参数 json
 {
  "email": "xxxx@xx.com",
  "password": "123456789",
  "email_code": 333333,
  "invite_code": "",
  "recaptcha_data": ""
}
 
参数名 类型 必填 描述
email string ✔︎ 邮箱地址
password string ✔︎ 密码
email_code number ✖︎ 邮箱验证码
invite_code string ✖︎ 邀请码
recaptcha_data string ✖︎ 人机验证数据
  • 成功返回示例 json
{
  "data": {
    "token": "xxx",
    "auth_data": "xxx"
  }
}
 
参数名 类型 描述
token string 用户 token
auth_data string base64(邮箱:密码)

6.重置密码

POST /passport/auth/forget

  • 请求参数 json
{
  "email": "xxxx@xx.com",
  "password": "123456789",
  "email_code": 333333
}
 
参数名 类型 必填 描述
email string ✔︎ 邮箱地址
email_code number ✔︎ 邮箱验证码
password string ✔︎ 用户密码
  • 成功返回示例 json
{
  "data": true
}
 
参数名 类型 描述
data boolean 是否重置成功

User

1.登出

GET /user/logout

  • 请求参数 null

  • 成功返回示例 json

{
  "data": true
}
 
参数名 类型 描述
data boolean 是否登出成功

2.账号信息

GET /user/info

  • 请求参数 null

  • 成功返回示例 json

{
  "data": {
    "email": "xxxx@xx.com",
    "transfer_enable": 0,
    "last_login_at": null,
    "created_at": 1234567890,
    "banned": 0,
    "remind_expire": 0,
    "remind_traffic": 0,
    "expired_at": 0,
    "balance": 0,
    "commission_balance": 0,
    "plan_id": null,
    "discount": null,
    "commission_rate": null,
    "telegram_id": null,
    "uuid": "xxxxxx-xxxx-xxxx-xxxx-xxxxxx",
    "avatar_url": "https://xxxx.com/xxx.xxx"
  }
}
 
参数名 类型 描述
email string 邮箱地址
transfer_enable number 总可用流量
last_login_at timestamp 最后登入时间
created_at timestamp 创建时间
banned number 是否封禁使用
remind_expire number 到期邮件提醒
remind_traffic number 流量邮件提醒
expired_at timestamp 过期时间
balance number 用户余额
commission_balance number 佣金余额
plan_id number - object(&plan) 当前订阅id
discount number 消费折扣
commission_rate number 佣金率
telegram_id number 绑定TG id
uuid string 唯一UUID
avatar_url string 头像地址

3.订阅信息

GET /user/getSubscribe

  • 请求参数 null

  • 成功返回示例 json

{
  "data": {
    "plan_id": null,
    "token": "xxx",
    "expired_at": 0,
    "u": 0,
    "d": 0,
    "transfer_enable": 0,
    "email": "xxx@xxx.com",
    "subscribe_url": "https://xxx.com/api/v1/client/subscribe?token=xxx",
    "reset_day": null
  }
}
 
参数名 类型 描述
plan_id number - object(&plan) 订阅id
token string 用户 token
expired_at timestamp 过期时间
u number 已用上行流量
d number 已用下行流量
transfer_enable number 总可用流量
email string 邮箱地址
subscribe_url string 订阅链接
reset_day number 重置日

4.重置订阅链接

GET /user/resetSecurity

  • 请求参数 null

  • 成功返回示例 json

{
  "data": "https://xxx.com/api/v1/client/subscribe?token=xxx"
}
 
参数名 类型 描述
data string 订阅链接

5.代办事项

GET /user/getStat

  • 请求参数 null

  • 成功返回示例 json

{
  "data": [
    0,
    0,
    0
  ]
}
 
参数名 类型 描述
data[0] number 待付订单
data[1] number 代办工单
data[2] number 待确认邀请

6.修改密码

POST /user/changePassword

  • 请求参数 json
{
  "old_password": "123456789",
  "new_password": "1234567890"
}
 
参数名 类型 必填 描述
old_password string ✔︎ 旧密码
new_password string ✔︎ 新密码
  • 成功返回示例 json
{
  "data": true
}
 
参数名 类型 描述
data boolean 是否修改成功

7.通知状态

POST /user/update

  • 请求参数 json
{
  "remind_expire": 0
}
 
参数名 类型 必填 描述
remind_expire number ✖︎︎ 到期邮件提醒
remind_traffic number ✖︎ 流量邮件提醒
  • 成功返回示例 json
{
  "data": true
}
 
参数名 类型 描述
data boolean 是否修改成功

8.佣金划转

POST /user/transfer

  • 请求参数 json
{
  "transfer_amount": 1000
}
 
参数名 类型 必填 描述
transfer_amount number ✔︎ 划转金额
  • 成功返回示例 json
{
  "data": true
}
 
参数名 类型 描述
data boolean 是否划转成功

Plan

1.订阅商店列表

GET /user/plan/fetch

  • 请求参数 null

  • 成功返回示例 json

{
  "data": [
    {
      "id": 1,
      "group_id": 1,
      "transfer_enable": 100,
      "name": "Plan name",
      "show": 1,
      "sort": null,
      "renew": 1,
      "content": "xxx",
      "month_price": 10,
      "quarter_price": null,
      "half_year_price": null,
      "year_price": 20000,
      "two_year_price": null,
      "three_year_price": null,
      "onetime_price": null,
      "reset_price": 1000,
      "reset_traffic_method": null,
      "created_at": 1234567890,
      "updated_at": 1234567890
    }
  ]
}
 
参数名 类型 描述
id number 订阅id
group_id number 权限组id
transfer_enable number 可用流量
name string 套餐名称
show number 是否显示
sort string 分类
renew number 开启续费
content string 套餐描述
month_price number 月付价格
quarter_price number 季度价格
half_year_price number 半年价格
year_price number 年价格
two_year_price number 两年价格
three_year_price number 三年价格
onetime_price number 一次性价格
reset_price number 重置价格
reset_traffic_method number 重置流量方式
created_at timestamp 套餐创建时间
updated_at timestamp 套餐更新时间

Order

1.订单列表

GET /user/order/fetch

  • 请求参数 null

  • 成功返回示例 json

{
  "data": [
    {
      "invite_user_id": null,
      "plan_id": 1,
      "coupon_id": null,
      "payment_id": 10,
      "type": 1,
      "cycle": "month_price",
      "trade_no": "xxx",
      "callback_no": null,
      "total_amount": 10,
      "discount_amount": null,
      "surplus_amount": null,
      "refund_amount": null,
      "balance_amount": null,
      "surplus_order_ids": null,
      "status": 2,
      "commission_status": 0,
      "commission_balance": 0,
      "paid_at": null,
      "created_at": 1234567890,
      "updated_at": 1234567890,
      "plan": {
        "表关联"
      }
    }
  ]
}
 
参数名 类型 描述
invite_user_id number 邀请人id
plan_id number 订阅id
coupon_id number 优惠券id
payment_id number 支付方式id
type number 订单类型 1新购2续费3升级
cycle string 订阅周期
trade_no string 订单号
callback_no string 退款单号
total_amount number 总金额
discount_amount number 折扣金额
surplus_amount number 剩余价值
refund_amount number 退款金额
balance_amount number 使用余额
surplus_order_ids number 折抵订单
status number 订单状态 0待支付1开通中2已取消3已完成4已折抵
commission_status number 佣金状态 0待确认1发放中2有效3无效
commission_balance number 佣金余额
paid_at timestamp 支付时间
created_at timestamp 创建时间
updated_at timestamp 更新时间
plan 关联表 订阅详情

2.支付方式

GET /user/order/getPaymentMethod

  • 请求参数 null

  • 成功返回示例 json

{
  "data": [
    {
      "id": 10,
      "name": "pay",
      "payment": "XXXPay"
    }
  ]
}
 
参数名 类型 描述
id number 支付id
name string 支付名称
payment string 支付模块

3.订单详情

GET /user/order/details?trade_no={trade_no}

  • 请求参数 query
参数名 类型 描述
trade_no string 订单号
  • 成功返回示例 json
{
  "data": {
    "id": 1275,
    "invite_user_id": null,
    "user_id": 2057,
    "plan_id": 1,
    "coupon_id": null,
    "payment_id": null,
    "type": 1,
    "cycle": "month_price",
    "trade_no": "xxx",
    "callback_no": null,
    "total_amount": 10,
    "discount_amount": null,
    "surplus_amount": null,
    "refund_amount": null,
    "balance_amount": null,
    "surplus_order_ids": null,
    "status": 0,
    "commission_status": 0,
    "commission_balance": 0,
    "paid_at": null,
    "created_at": 1234567890,
    "updated_at": 1234567890,
    "plan": {
      "表关联"
    },
    "try_out_plan_id": 0
  }
}
 
参数名 类型 描述
id number 订单id
invite_user_id number 邀请人id
user_id number 用户id
user_id number 用户自增id
plan_id number 订阅id
coupon_id number 优惠券id
payment_id number 支付方式id
type number 订单类型 1新购2续费3升级
cycle string 订阅周期
trade_no string 订单号
callback_no string 退款单号
total_amount number 总金额
discount_amount number 折扣金额
surplus_amount number 剩余价值
refund_amount number 退款金额
balance_amount number 使用余额
surplus_order_ids number 折抵订单
status number 订单状态 0待支付1开通中2已取消3已完成4已折抵
commission_status number 佣金状态 0待确认1发放中2有效3无效
commission_balance number 佣金余额
paid_at timestamp 支付时间
created_at timestamp 创建时间
updated_at timestamp 更新时间
plan 关联表 订阅详情
try_out_plan_id number 试用计划 ID

4.订单状态

GET /user/order/check?trade_no={trade_no}

  • 请求参数 query
参数名 类型 描述
trade_no string 订单号
  • 成功返回示例 json
{
  "data": 0
}
 
参数名 类型 描述
data number 0待支付1开通中2已取消3已完成4已折抵

5.创建订单

POST /user/order/save

  • 请求参数 json
{
  "cycle": "month_price",
  "plan_id": 1
}
 
参数名 类型 描述
cycle string 订阅周期
plan_id number 订阅id
  • 成功返回示例 json
{
  "data": "xxx"
}
 
参数名 类型 描述
data string 订单号

6.结算订单

POST /user/order/checkout

  • 请求参数 json
{
  "trade_no": "xxx",
  "method": 1
}
 
参数名 类型 描述
trade_no string 订单号
method number 支付id
  • 成功返回示例 json
{
  "type": 0,
  "data": "xxx"
}
 
参数名 类型 描述
type number 0:qrcode 1:url
data string 付款地址

7.关闭订单

POST /user/order/cancel

  • 请求参数 json
{
  "trade_no": "xxx"
}
 
参数名 类型 描述
trade_no string 订单号
  • 成功返回示例 json
{
  "data": true
}
 
参数名 类型 描述
data boolean 是否关闭成功

Invite

1.邀请码管理

GET /user/invite/fetch

  • 请求参数 null

  • 成功返回示例 json

{
  "data": {
    "codes": [
      {
        "id": 1,
        "user_id": 1,
        "code": "xxx",
        "status": 0,
        "pv": 0,
        "created_at": 1234567890,
        "updated_at": 1234567890
      }
    ],
    "stat": [
      0,
      0,
      0,
      15,
      0
    ]
  }
}
 
参数名 类型 描述
codes.id number 邀请码id
codes.user_id number 用户id
codes.code array 邀请码
codes.status number 邀请码状态
codes.pv number 访问量
codes.created_at timestamp 创建时间
codes.updated_at timestamp 更新时间
stat[0] number 已注册用户数
stat[1] number 有效的佣金
stat[2] number 确认中的佣金
stat[3] number 佣金比例
stat[4] number 可用佣金

2.生成邀请码

GET /user/invite/save

  • 请求参数 null

  • 成功返回示例 json

{
  "data": true
}
 
参数名 类型 描述
data boolean 生成成功

3.邀请明细

GET /user/invite/details

  • 请求参数 null

  • 成功返回示例 json

{
  "id": 1,
  "commission_status": 1,
  "commission_balance": 10,
  "created_at": 1234567890,
  "updated_at": 1234567890
}
 
参数名 类型 描述
id number 邀请id
commission_status number 佣金状态 0待确认1发放中2有效3无效
commission_balance number 佣金
created_at timestamp 创建时间
updated_at timestamp 更新时间

Notice

1.公告信息

GET /user/notice/fetch

  • 请求参数 null

  • 成功返回示例 json

{
  "data": [
    {
      "id": 1,
      "title": "xxx",
      "content": "xxx",
      "img_url": null,
      "created_at": 1234567890,
      "updated_at": 1234567890
    }
  ],
  "total": 1
}
 
参数名 类型 描述
id number 公告id
title string 标题
content string 内容
img_url timestamp 背景图片
created_at timestamp 创建
updated_at timestamp 更新时间
total number 总条数

「梦想一旦被付诸行动,就会变得神圣,如果觉得我的文章对您有用,请帮助本站成长」

赞(0) 打赏
一分也是爱

支付宝扫一扫打赏

微信扫一扫打赏

上一篇:

下一篇:

相关推荐

博客简介

本站CDN采用VmShell免费提供离中国大陆最近的香港CMI高速网络做支撑,ToToTel打造全球最快速的边沿网络支撑服务,具体详情请见 :https://vmshell.com/ 以及 https://tototel.com/,网站所有的文件和内容禁止大陆网站搬迁复制,谢谢,VPS营销投稿邮箱: admin@linuxxword.com,我们免费帮大家发布,不收取任何费用,请提供完整测试文稿!

精彩评论

友情链接

他们同样是一群网虫,却不是每天泡在网上游走在淘宝和网游之间、刷着本来就快要透支的信用卡。他们或许没有踏出国门一步,但同学却不局限在一国一校,而是遍及全球!申请交换友链

站点统计

  • 文章总数: 2599 篇
  • 草稿数目: 23 篇
  • 分类数目: 6 个
  • 独立页面: 0 个
  • 评论总数: 2 条
  • 链接总数: 0 个
  • 标签总数: 13279 个
  • 注册用户: 139 人
  • 访问总量: 8,666,412 次
  • 最近更新: 2024年11月27日