本文档旨在指导开发者如何在使用 Stripe 预构建 Checkout 集成到网站后，获取客户数据（特别是 Customer ID），并将其存储到 MySQL 数据库中。重点介绍如何通过 Stripe Webhooks 监听 checkout.session.completed 事件，并从中提取所需的客户信息。
Stripe 预构建 Checkout 提供了一种快速且安全的方式来接受付款，但有时我们需要在自己的数据库中存储客户信息，例如 Customer ID。由于 Checkout 会自动根据用户提供的邮箱等信息创建客户，我们需要一种方法来获取这个 Customer ID。本文将介绍如何通过 Stripe Webhooks 实现这一目标。
1. 创建 Checkout Session
首先，我们需要创建一个 Checkout Session。以下是一个示例 PHP 代码：
['card'],
'line_items' => [[
'price'=>"price_1Jt.....vImqj",
'quantity'=>1,
]],
'mode' => 'subscription',
'success_url' => $YOUR_DOMAIN . '/success.php',
'cancel_url' => $YOUR_DOMAIN . '/cancel.html',
]);
header("HTTP/1.1 303 See Other");
header("Location: " . $checkout_session->url);注意: sk_test_51J...........esLwtMQx7IXNxp00epljtC43 替换为你自己的 Stripe 测试密钥。mydomain.com 替换为你自己的域名。
在创建 Checkout Session 时，我们没有显式地传递 customer 参数。这意味着 Stripe 将根据用户在 Checkout 流程中提供的信息自动创建一个新的 Customer 对象。
2. 设置 Stripe Webhooks
Webhooks 允许你的应用程序在 Stripe 上发生特定事件时接收实时通知。 为了获取 Customer ID，我们需要监听 checkout.session.completed 事件。
2.1. 创建 Webhook Endpoint
首先，你需要创建一个 Webhook endpoint，Stripe 将向其发送事件数据。 这个 endpoint 应该是一个可以接收 POST 请求的 URL。
type == 'checkout.session.completed') {
$session = $event->data->object;
// Get the Customer ID
$customer_id = $session->customer;
// TODO: Store the Customer ID in your database
// Example:
// $mysqli = new mysqli("localhost", "user", "password", "database");
// $stmt = $mysqli->prepare("INSERT INTO customers (customer_id) VALUES (?)");
// $stmt->bind_param("s", $customer_id);
// $stmt->execute();
echo "Customer ID: " . $customer_id . "\n";
}
http_response_code(200); // Return a 200 OK response注意: whsec_YOUR_WEBHOOK_SECRET 替换为你自己的 Webhook Secret。 sk_test_51J...........esLwtMQx7IXNxp00epljtC43 替换为你自己的 Stripe 测试密钥。 确保你的 Webhook endpoint 可以公开访问。
2.2. 配置 Webhook
- 登录你的 Stripe 仪表盘。
- 导航到 "开发者" -> "Webhooks"。
- 点击 "添加 endpoint"。
- 在 "Endpoint URL" 字段中输入你的 Webhook endpoint 的 URL。
- 在 "要发送的事件" 部分，选择 "checkout.session.completed"。
- 点击 "添加 endpoint"。
3. 处理 checkout.session.completed 事件
当 Checkout Session 成功完成时，Stripe 会向你的 Webhook endpoint 发送一个 checkout.session.completed 事件。 在你的 Webhook endpoint 中，你需要解析这个事件并提取 Customer ID。
婚纱影楼小程序提供了一个连接用户与影楼的平台，相当于影楼在微信的官网。它能帮助影楼展示拍摄实力，记录访客数据，宣传优惠活动。使用频率高，方便传播，是影楼在微信端宣传营销的得力助手。功能特点：样片页是影楼展示优秀摄影样片提供给用户欣赏并且吸引客户的。套系页是影楼根据市场需求推出的不同套餐，用户可以按照自己的喜好预定套系。个人中心可以查看用户预约的拍摄计划，也可以获取到影楼的联系方式。
在上面的示例代码中，我们已经演示了如何处理 checkout.session.completed 事件，并从中提取 Customer ID。
4. 将 Customer ID 存储到数据库
最后，你需要将提取到的 Customer ID 存储到你的 MySQL 数据库中。 在上面的示例代码中，我们提供了一个简单的示例，展示了如何使用 PHP 和 MySQLi 扩展来将 Customer ID 插入到 customers 表中。 你需要根据你的实际数据库结构和需求进行修改。
注意: 请务必对数据库操作进行适当的错误处理和安全措施，以防止 SQL 注入等安全问题。
5. 可选: 传递现有 Customer ID
如果你希望在创建 Checkout Session 时使用现有的 Customer ID，可以在创建 Checkout Session 时传递 customer 参数。
['card'],
'line_items' => [[
'price'=>"price_1Jt.....vImqj",
'quantity'=>1,
]],
'mode' => 'subscription',
'success_url' => $YOUR_DOMAIN . '/success.php',
'cancel_url' => $YOUR_DOMAIN . '/cancel.html',
'customer' => $existing_customer_id, // Pass the existing Customer ID
]);
header("HTTP/1.1 303 See Other");
header("Location: " . $checkout_session->url);注意: cus_XXXXXXXXXXXXXXX 替换为你自己的 Customer ID。
如果传递了 customer 参数，Stripe 将不会创建新的 Customer 对象，而是使用指定的 Customer 对象。
总结
通过使用 Stripe Webhooks，我们可以轻松地获取 Stripe Checkout 创建的 Customer ID，并将其存储到我们的数据库中。 这使得我们可以更好地管理客户信息，并将其与其他业务数据集成。 请务必仔细阅读 Stripe 官方文档，并根据你的实际需求进行调整。 此外，请始终关注安全性，并采取必要的措施来保护你的数据。
