Skip to main content
本指南以 Node.js 后端为例,带你完成完整的支付集成。相同的概念适用于任何编程语言。

选择设置路径

  • 如果你想先手动创建产品并查看订单,请使用控制台指南。
  • 如果你的应用需要从服务端创建 Checkout Session,请使用 API 指南。
相关页面:

概览

1. 搭建服务器

安装所需依赖:
创建服务器文件:

2. 创建产品(一次性操作)

你只需创建一次产品,可以通过 API 或控制台完成。

3. 创建收银接口

添加一个在客户点击「购买」时创建 Checkout Session 的接口:

4. 处理前端重定向

在前端将客户重定向到收银页面:

5. 处理 Webhook

添加 Webhook 端点以接收支付通知:

6. 启动服务器

运行:

7. 测试流程

  1. 如果启润已为你的商户账号发放 staging 凭证,或启用了可测试的支付网关,请使用这些凭证和启润提供的支付场景运行流程。
  2. 如果你只有生产凭证,请在生产环境中使用低风险的真实付款验证流程。
  3. 确认客户会被重定向到启润支付收银页面。
  4. 确认你的服务器能收到付款 Webhook,并且履约逻辑能正确处理该事件。
  5. 如果你使用真实付款进行验证,请在需要时根据启润支持团队的指引退款或做相应运营处理。
当 Checkout 创建、重定向处理、Webhook 接收和履约逻辑都已通过启润为你账号启用的凭证和网关验证后,集成即可投入使用。

下一步

Webhook 事件

查看所有可用的 Webhook 事件类型

代码示例

查看其他语言的集成示例