自定义支付渠道

除了 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

订单总金额,单位:分

请求实例:

验证请求签名

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

  1. Authorization 值中 Bearer 之后的部分取出,使用:分割字符串,其第二部分是签名过期的时间戳,验证确保其大于当前时间戳。将:前一部分记为SIGNATURE

  2. 参考 getSignContent 对请求正文及 header进行编码,并使用 HMAC 算法对编码内容及过期时间戳计算签名:Sign

  3. 对比签名后的内容和SIGNATURE是否一致。

支付成功回调

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

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

GET <notify_url>

添加支付接口

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

第三方实现

支付平台
许可
文档

最后更新于

这有帮助吗?