前提条件
- 一个启润支付商户账号(点此注册)
- 你的 API 密钥(在控制台的「开发者」页面获取)
- 已在控制台或通过 Products API 创建产品
- 一个可以安全保存 API 密钥的服务端环境
- 上线前用于接收付款通知的 Webhook 端点
第一步:获取 API 密钥
注册后,前往 控制台 > 开发者,复制你的 API 密钥。- 生产密钥:
kyren_live_xxxxxxxxxxxx— 用于正式收款
第二步:创建产品
创建一个代表你所售商品的产品:id,后续创建 Checkout Session 时需要用到。
第三步:创建 Checkout Session
当客户要付款时,创建一个 Checkout Session:displayMerchantName。
响应中包含 url 字段 — 将客户重定向到该 URL 即可完成付款。
第四步:重定向到收银台
将客户重定向到第三步返回的 Checkout URL。客户会看到一个托管的支付页面,可以选择喜欢的支付方式。第五步:处理 Webhook
付款完成后,启润支付会向你的服务器发送 Webhook:在 控制台 > 开发者 > Webhook 设置 中配置你的 Webhook URL。
下一步
认证
了解 API 认证详情
Webhook 签名
实现安全的 Webhook 签名验证
测试
使用 Kyren 提供的 Staging 凭证或低风险真实付款安全测试
代码示例
查看 Python、Node.js、Go 等语言的示例