自定义支付渠道

除了 Cloudreve 已经支持的支付平台以外，你也可以通过实现 Cloudreve 的付款接口来对接你自己的支付平台，或是桥接其他第三方平台。

自定义支付接口你实现需要一个独立的 HTTP 服务，并提供：

暴露一个 API 端点，用于处理 Cloudreve 的创建订单请求，并返回支付页面 URL；
客户完成支付后，发送 HTTP 请求到指定的 URL 以通知 Cloudreve 支付完成。

支付接口定义

按照本章规范实现你的支付接口，部署接口并确保其能与 Cloudreve 相互进行网络通信。

创建订单

当有新订单创建时，Cloudreve 向支付你的接口发送的请求。

POST <你的支付接口>

Headers

Name

Type

Description

Authorization

String

使用您在后台设定的

通信密钥

计算的签名，详情请参阅“验证请求签名”小节

X-Cr-Cloudreve-Version

String

Cloudreve 主程序的版本

X-Cr-Site-Id

String

Cloudreve 的站点 ID，可用于区分不同站点

X-Cr-Site-Url

String

Cloudreve 的站点 URL

Request Body

Name

Type

Description

name*

String

订单标题

order_no*

String

订单编号

notify_url*

String

支付成功的回调通知 URL，详情请参考后续“支付成功回调”章节。请存储此项以便后续使用。

amount*

String

订单总金额，单位：分

{
    // 成功的响应固定为 0
    "code": 0,
    // 付款收银台页面的 URL，默认会被生成为二维码展示给用户，用户也可选择直接
    // 打开此 URL
    "data": "https://examplepayment.com/checkout/26544743"
}

{
    // 任意非0代码表示订单创建失败
    "code": 500,
    // 错误的详细描述
    "error": "Failed to create a payment."
}

请求实例：

POST /order/create
Host: examplepayment.com
Authorization: Bearer Vep6hl1x8fiQLasEauMEUqxFKyEqSXb9D_BBQpOiTd8=:1676027218
X-Cr-Site-Url: https://demo.cloudreve.org
X-Cr-Site-Id: b7de8bba-8f86-40fe-8171-c2625b6c4a61
X-Cr-Cloudreve-Version: 3.6.2

{
   "name":"Cloudreve - 10 GB 容量包",
   "order_no":"20230209190648343421",
   "notify_url":"http://demo.cloudreve.org/api/v3/callback/custom/20230209190648343421/363f8866-6d0a-4dbf-a560-0c17de2eb7f9?sign=F-AdeTf7cR1uwmV1dqJ1kN_POGivKk_awMRPZUCZyhA%3D%3A1676027208",
   "amount":100
}

验证请求签名

你可以在 Cloudreve 后台设定通信密钥，Cloudreve 创建订单的请求会使用此密钥进行加密并放在Authorization header 中，你可以通过以下算法验证这一签名：

将 Authorization 值中 Bearer 之后的部分取出，使用:分割字符串，其第二部分是签名过期的时间戳，验证确保其大于当前时间戳。将:前一部分记为SIGNATURE；
参考 getSignContent 对请求正文及 header进行编码，并使用 HMAC 算法对编码内容及过期时间戳计算签名：Sign；
对比签名后的内容和SIGNATURE是否一致。

支付成功回调

当用户完成支付后，你需要向此订单被创建时制定的 notify_url 发送一个 GET 请求以通知 Cloudreve 用户完成支付。如果回调请求失败，请以指数后退间隔进行重试，除非响应中明确返回了错误信息及代码。

用户完成支付后，向订单关联的 `notify_url` 发送请求通知 Cloudreve 支付成功。

GET <notify_url>

{
    "code": 0
}

{
    // 任意非0代码表示订单创建失败
    "code": 500,
    // 错误的详细描述
    "error": "Failed to fulfill a payment."
}

添加支付接口

实现并部署支付接口后，请在 Cloudreve 后台 - 增值服务 - 自定义支付渠道中开启并填写接口地址。

第三方实现

支付平台

许可

文档

易支付

开放源代码

爱发电

MIT许可

上一页iOS 客户端批量授权下一页数据库脚本

最后更新于1年前