自定义支付渠道
Last updated
Last updated
除了 Cloudreve 已经支持的支付平台以外，你也可以通过实现 Cloudreve 的付款接口来对接你自己的支付平台，或是桥接其他第三方平台。
自定义支付接口你实现需要一个独立的 HTTP 服务，并提供：
暴露一个 API 端点，用于处理 Cloudreve 的创建订单请求，并返回支付页面 URL；
客户完成支付后，发送 HTTP 请求到指定的 URL 以通知 Cloudreve 支付完成。
按照本章规范实现你的支付接口，部署接口并确保其能与 Cloudreve 相互进行网络通信。
POST <你的支付接口>
| Name | Type | Description |
|---|---|---|
请求实例：
你可以在 Cloudreve 后台设定通信密钥，Cloudreve 创建订单的请求会使用此密钥进行加密并放在Authorization header 中，你可以通过以下算法验证这一签名：
将 Authorization 值中 Bearer 之后的部分取出，使用:分割字符串，其第二部分是签名过期的时间戳，验证确保其大于当前时间戳。将:前一部分记为SIGNATURE；
参考 getSignContent 对请求正文及 header进行编码，并使用 HMAC 算法对编码内容及过期时间戳计算签名：Sign；
对比签名后的内容和SIGNATURE是否一致。
当用户完成支付后，你需要向此订单被创建时制定的 notify_url 发送一个 GET 请求以通知 Cloudreve 用户完成支付。如果回调请求失败，请以指数后退间隔进行重试，除非响应中明确返回了错误信息及代码。
GET <notify_url>
实现并部署支付接口后，请在 Cloudreve 后台 - 增值服务 - 自定义支付渠道 中开启并填写接口地址。
| 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
name*
String
订单标题
order_no*
String
订单编号
notify_url*
String
支付成功的回调通知 URL，详情请参考后续“支付成功回调”章节。请存储此项以便后续使用。
amount*
String
订单总金额，单位：分
易支付
开放源代码
爱发电
MIT许可