从 Stripe 预构建结账页面获取客户数据

霞舞
发布: 2025-09-30 19:50:25
原创
996人浏览过

从 stripe 预构建结账页面获取客户数据

本文档介绍了如何在使用 Stripe 预构建结账页面后获取客户数据,特别是客户 ID,以便将其存储在数据库中。重点在于利用 Stripe Webhooks 监听 checkout.session.completed 事件,并提供相关文档链接,帮助开发者成功集成和处理客户信息。

使用 Stripe Webhooks 获取客户 ID

Stripe 预构建结账页面简化了支付流程,但有时需要获取客户信息,例如客户 ID,以便在自己的系统中进行管理。由于 Stripe 会自动处理客户的创建,因此需要使用 Webhooks 来获取相关信息。

方法:通过 Webhooks 监听 checkout.session.completed 事件

当用户成功完成结账流程后,Stripe 会触发 checkout.session.completed 事件。我们可以设置 Webhook 来监听此事件,并在事件处理程序中获取客户 ID。

步骤 1:配置 Webhook 端点

首先,需要在 Stripe 控制台中配置一个 Webhook 端点。这个端点是一个 URL,Stripe 会将事件数据以 POST 请求的形式发送到这个 URL。

  1. 登录 Stripe 控制台:https://www.php.cn/link/65b6edfd9f135a6a1dbe075fb82c411f
  2. 导航到 "开发者" -youjiankuohaophpcn "Webhooks"。
  3. 点击 "添加端点"。
  4. 输入你的 Webhook URL。
  5. 选择要监听的事件:checkout.session.completed。
  6. 保存配置。

步骤 2:编写 Webhook 处理程序

接下来,需要编写 Webhook 处理程序来接收和处理 checkout.session.completed 事件。以下是一个使用 PHP 的示例:

Kits AI
Kits AI

Kits.ai 是一个为音乐家提供一站式AI音乐创作解决方案的网站,提供AI语音生成和免费AI语音训练

Kits AI 413
查看详情 Kits AI
<?php

require 'vendor/autoload.php';

// Replace with your actual secret key
\Stripe\Stripe::setApiKey('sk_test_51J...........esLwtMQx7IXNxp00epljtC43');

// You need to configure the webhook endpoint secret in your Stripe dashboard
$endpoint_secret = 'whsec_...';

$payload = @file_get_contents('php://input');
$sig_header = $_SERVER['HTTP_STRIPE_SIGNATURE'];
$event = null;

try {
    $event = \Stripe\Webhook::constructEvent(
        $payload, $sig_header, $endpoint_secret
    );
} catch(\UnexpectedValueException $e) {
    // Invalid payload
    http_response_code(400);
    exit();
} catch(\Stripe\Exception\SignatureVerificationException $e) {
    // Invalid signature
    http_response_code(400);
    exit();
}

// Handle the checkout.session.completed event
if ($event->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:
    // $db = new PDO('mysql:host=localhost;dbname=your_database', 'username', 'password');
    // $stmt = $db->prepare("INSERT INTO customers (stripe_customer_id) VALUES (?)");
    // $stmt->execute([$customer_id]);

    error_log("Customer ID: " . $customer_id);
}

http_response_code(200); // Acknowledge receipt of the event
登录后复制

代码解释:

  • 首先,引入 Stripe PHP 库并设置 API 密钥。
  • 然后,从请求中获取事件负载和签名,并使用 Stripe Webhook Secret 验证事件的真实性。
  • 如果事件类型是 checkout.session.completed,则从事件数据中提取 customer 字段,该字段包含客户 ID。
  • 最后,将客户 ID 存储到数据库中。

步骤 3:配置 Checkout Session (可选)

如果在创建 Checkout Session 时已经有 Customer ID,可以直接传入:

\Stripe\Stripe::setApiKey('sk_test_51J...........esLwtMQx7IXNxp00epljtC43');

header('Content-Type: application/json');

$YOUR_DOMAIN = 'mydomain.com';

$customer_id = 'cus_...'; // Replace with your existing customer ID

$checkout_session = \Stripe\Checkout\Session::create([
    'payment_method_types' => ['card'],
    'line_items' => [[
      'price'=>"price_1Jt.....vImqj",
      'quantity'=>1,
    ]],
    'mode' => 'subscription',
    'customer' => $customer_id, // Pass existing customer ID
    'success_url' => $YOUR_DOMAIN . '/success.php',
    'cancel_url' => $YOUR_DOMAIN . '/cancel.html',
  ]);
登录后复制

注意事项:

  • 务必验证 Webhook 事件的签名,以确保事件来自 Stripe,而不是恶意攻击者。
  • 在生产环境中,使用安全的数据库连接和参数化查询,以防止 SQL 注入攻击。
  • 处理 Webhook 事件时,要快速响应,避免长时间阻塞 Stripe 的 Webhook 服务器。如果需要执行耗时操作,可以使用队列或异步任务
  • endpoint_secret 可以在 Stripe 控制台的 Webhook 端点配置中找到。

总结

通过设置 Stripe Webhook 并监听 checkout.session.completed 事件,可以有效地获取使用 Stripe 预构建结账页面创建的客户的 ID。 这使得您可以将 Stripe 的支付功能与自己的数据库和客户管理系统集成,从而实现更完善的业务流程。 记住要验证 Webhook 事件的签名,并安全地存储客户数据。

以上就是从 Stripe 预构建结账页面获取客户数据的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号