跳到主内容

产品

添加你想出售的商品（或服务）。每个商品包含：Tag、Detail、Currency、Price、Quantity、Sold 和 Is recharge（用于可自定义金额的余额充值商品）。

product_field.png

充值商品​

开启 Is recharge 后，商品用于给用户余额充值。可以配置：

  • 预设金额：固定选项（例如 $10、$50、$100），在商店中以可点击的标签显示（最多显示三个，更多时显示 "+N"）。
  • 自定义金额：让用户输入任意金额，商店会显示 "Custom amount available"。

可以同时提供预设金额和自定义金额，也可以关闭自定义金额只允许预设（至少要有一个）。付款后，所选金额会充入用户余额。

支付提供商​

为商品关联一个或多个 支付提供商。 Currency 必填，没有币种的商品不能保存。 Casdoor 会检查所选币种是否与每个关联的提供商匹配（例如 USD 商品配 PayPal）；不匹配时创建或更新会失败。

如果没有明确添加支付提供商，Casdoor 会从 Payment 类别的可用提供商中自动分配一个。也就是说，只要组织中至少有一个支付提供商，新创建的商品无需手动配置提供商就能立即购买。

备注

支付宝只支持 CNY。为其他币种的商品选择支付宝会校验失败。

product_provider.png

Success URL（可选）​

要在付款后把用户跳转到自定义地址而不是 Casdoor 回调，设置 Success URL。配置后，Casdoor 会把支付所有者和交易名称作为查询参数追加到你提供的地址上。

例如，把 Success URL 设为 http://example.com/payment/success，用户会被跳转到：

http://example.com/payment/success?transactionOwner={paymentOwner}&transactionName={paymentName}

可以在 Success URL 上加可选的查询参数，例如：

http://example.com/payment/success?customParam=value&transactionOwner={paymentOwner}&transactionName={paymentName}

:::警告

**重要：**如果配置了 Success URL 字段，必须手动调用 NotifyPayment API 来完成交易，否则支付会失败。

用 Success URL 查询字符串中的参数调用接口：api/notify-payment/{paymentOwner}/{paymentName}。

:::

API​

buy-product（已弃用）​

保留 /api/buy-product 接口，是为了兼容基于旧版 Casdoor 开发的集成。它在内部先调用 place-order 再调用 pay-order，返回相同的支付响应。

**新的集成应分别调用 place-order 和 pay-order。**两步流程让你有更多控制：可以在发起支付前检查订单，并分别处理每一步的错误。

访问控制​

商品、订单、支付、计划、定价和订阅只有管理员可以编辑。非管理员用户可以查看这些资源，但不能创建、修改或删除。以非管理员身份查看时，操作按钮和表单控件处于禁用状态，防止未授权的修改。

预览产品​

你已经完成了！查看详细信息并保存：

产品预览