Skip to content

README-zh.md

Latest commit

 

History

History
56 lines (38 loc) · 2.04 KB

README-zh.md

File metadata and controls

56 lines (38 loc) · 2.04 KB

CPPay WordPress Plugin

在 WordPress 中使用 CPPay API 创建并查询加密支付，不在前端暴露 API Key。

安装

参考: https://www.cppay.finance/docs/zh/guide/wordpress-plugin.html

功能

  • 在 WooCommerce 支付页通过“管理”按钮配置 API Key
  • WooCommerce 网关注册，支付方式会显示在结账页
  • 下单后通过 OTT 跳转到 https://www.cppay.finance/payment/{ott} 托管支付页
  • 提供 WooCommerce webhook 回调入口，支付完成后自动更新订单状态
  • 短代码方式插入支付组件
  • 支持一次性支付 instant 和订阅支付 subscription

WooCommerce 结账页展示

启用网关后，CPPay 会作为支付方式出现在 WooCommerce 结账页。

支付设置页路径示例：

  • wp-admin/admin.php?page=wc-settings&tab=checkout（旧版）

  • wp-admin/admin.php?page=wc-settings&tab=checkout&section=cppay_gateway（管理页）

  • wp-admin/admin.php?page=wc-settings&tab=payments（新版）

  • 结账选择 CPPay

  • 下单时插件会调用 POST /api/payment/ott/create 创建 OTT（使用 Authorization: ApiKey {api_key}）

  • 然后跳转到 https://www.cppay.finance/payment/{ott} 完成支付

  • Thank You 页面会保留 OTT 链接作为兜底入口

  • 收到 webhook 后，插件会调用 CPPay 状态查询接口确认结果，并把 WooCommerce 订单更新为 completed 或 failed

短代码

[cppay_payment plain="instant" amount="10" order_prefix="blog" title="Pay with Crypto"]

订阅支付示例：

[cppay_payment plain="subscription" amount="9.99" interval_days="30" order_prefix="sub"]

与 cppay-sdk API 对齐

本插件 PHP 客户端与 cppay-sdk/src/assets/request.ts 对齐了以下接口：

  • GET /api/payment/token
  • POST /api/payment/create
  • GET /api/payment/query
  • POST /api/subscription/create
  • GET /api/subscription/query

并将返回字段映射为 SDK 常见格式，例如 paymentId, subscriptionId, paymentAmount, expireAt, status。