Stripe 支付集成小白完全指南

https://stripe.com/

一、基础概念解释

1.1 什么是 Stripe？

通俗解释：Stripe 就像是一个"网上收银台"。就像实体店有 POS 机刷卡一样，Stripe 帮助网站收取客户的信用卡付款。

类比：

• 淘宝用支付宝收钱
• Stripe 帮国外网站收钱
• 都是"中间人"，负责安全地处理付款

1.2 为什么要用 Stripe？

• 全球通用：支持 135+ 种货币，覆盖 40+ 个国家
• 安全可靠：不需要你存储客户的信用卡信息
• 简单易用：几行代码就能接入
• 合规性强：自动处理各种金融法规要求

二、核心名词解释

2.1 API 相关

API（应用程序接口）

• 是什么：就像餐厅的菜单，告诉你能点什么菜，怎么点
• 作用：让你的网站能和 Stripe "对话"
• 例子：你说"收款 100 美元"，Stripe 就执行收款

API Keys（API 密钥）

• 是什么：就像你家的钥匙，有了它才能进门
• 种类：
  • Publishable Key（公开密钥）：像门牌号，可以公开，用在网页上
  • Secret Key（私密密钥）：像保险箱密码，绝对保密，只在服务器用
• 格式：

plain
公开密钥：pk_test_51ABC...（以 pk_ 开头）私密密钥：sk_test_51XYZ...（以 sk_ 开头）

SDK（软件开发工具包）

• 是什么：Stripe 提供的"工具箱"，里面有各种现成的工具
• 类比：就像组装家具的工具包，有螺丝刀、扳手等
• 作用：不用从零开始写代码，直接用现成的

2.2 支付流程名词

Checkout Session（结账会话）

• 是什么：一次支付的"临时房间"
• 类比：像去银行办业务时的叫号单
• 包含信息：
  • 要付多少钱
  • 买什么东西
  • 付款成功后去哪里
  • 取消付款后去哪里

Payment Intent（支付意图）

• 是什么：一笔具体的付款记录
• 类比：像购物小票，记录这次交易的所有信息
• 状态变化：

plain
创建 → 处理中 → 成功/失败

Customer（客户）

• 是什么：在 Stripe 中保存的客户信息
• 好处：客户下次购买不用重新输入信息
• 包含：邮箱、姓名、付款方式等

2.3 技术架构名词

Frontend（前端）

• 是什么：用户看得见的网页部分
• 职责：
  • 显示商品信息
  • 收集用户选择
  • 跳转到支付页面
• 类比：像商店的展示橱窗