Skip to main content
当你希望服务端通过 API 创建 Kyren Pay Checkout Session 时,请使用本指南。 如果你想先了解控制台,请从 控制台总览 开始。

前提条件

  • 一个启润支付商户账号(点此注册
  • 你的 API 密钥(在控制台的「开发者」页面获取)
  • 已在控制台或通过 Products API 创建产品
  • 一个可以安全保存 API 密钥的服务端环境
  • 上线前用于接收付款通知的 Webhook 端点

第一步:获取 API 密钥

注册后,前往 控制台 > 开发者,复制你的 API 密钥。
  • 生产密钥kyren_live_xxxxxxxxxxxx — 用于正式收款
请妥善保管你的 API 密钥。切勿在客户端代码或公开仓库中暴露密钥。

第二步:创建产品

创建一个代表你所售商品的产品:
保存响应中的 id,后续创建 Checkout Session 时需要用到。

第三步:创建 Checkout Session

当客户要付款时,创建一个 Checkout Session:
当本次 Checkout 需要展示不同于商户账户名称的活动、店铺或应用名称时,可以传入 displayMerchantName 响应中包含 url 字段 — 将客户重定向到该 URL 即可完成付款。

第四步:重定向到收银台

将客户重定向到第三步返回的 Checkout URL。客户会看到一个托管的支付页面,可以选择喜欢的支付方式。

第五步:处理 Webhook

付款完成后,启润支付会向你的服务器发送 Webhook:
控制台 > 开发者 > Webhook 设置 中配置你的 Webhook URL。

下一步

认证

了解 API 认证详情

Webhook 签名

实现安全的 Webhook 签名验证

测试

使用 Kyren 提供的 Staging 凭证或低风险真实付款安全测试

代码示例

查看 Python、Node.js、Go 等语言的示例