Stripe Connect Express账户集成指南：现代化API流程详解

本教程详细介绍了stripe connect express账户的现代化集成流程，摒弃了过时的oauth方法，转而采用stripe api直接创建账户并生成账户链接。通过三个核心步骤——创建express账户、生成账户链接、引导用户跳转，开发者可以更灵活、安全地管理和引导第三方用户完成stripe平台的入驻流程，确保集成符合最新的推荐实践。

Stripe Connect Express账户集成概述

Stripe Connect 允许平台为第三方卖家或服务提供商（即连接账户）处理支付。在集成过程中，引导这些连接账户完成Stripe的入驻流程是关键一环。早期的集成方式可能依赖于OAuth授权流程，但Stripe已更新并推荐使用更直接、更具控制力的API方法来管理Express账户的创建和入驻。这种现代化方法赋予平台显式控制权，以决定何时创建账户以及如何引导用户完成必要的设置。

现代化Express账户入驻流程

Stripe推荐的Express账户入驻流程主要包含以下三个核心步骤，它们共同构建了一个安全且用户友好的入驻体验：

步骤一：创建Express账户

在引导用户进行入驻之前，平台需要首先通过Stripe API为该用户创建一个Express类型的连接账户。这个账户将作为用户在Stripe生态系统中的唯一标识。

示例代码 (PHP):

集简云

软件集成平台，快速建立企业自动化与智能化

22

查看详情

<?php
require 'vendor/autoload.php'; // 引入Stripe PHP库

\Stripe\Stripe::setApiKey('YOUR_SECRET_KEY'); // 设置您的Stripe密钥

try {
    $account = \Stripe\Account::create([
        'type' => 'express', // 指定账户类型为Express
        // 可以根据需要添加其他参数，例如 'country', 'email' 等
    ]);
    echo "Express账户创建成功，账户ID: " . $account->id;
} catch (\Stripe\Exception\ApiErrorException $e) {
    echo "创建账户时发生错误: " . $e->getMessage();
}
?>

注意事项：

• type 参数必须设置为 'express' 来创建Express账户。
• 您可以选择在创建时传入用户的电子邮件地址或其他基本信息，以便Stripe预填充部分入驻表单，提升用户体验。
• 成功创建后，您将获得一个 account-youjiankuohaophpcnid，这是后续步骤中关联账户的关键。

步骤二：生成账户链接

创建账户后，下一步是生成一个短时有效的URL，用户将通过此链接进入Stripe的入驻流程页面。这个链接是动态生成的，并且包含必要的参数以确保用户被正确地引导到其对应的Express账户。

示例代码 (PHP):

<?php
require 'vendor/autoload.php'; // 引入Stripe PHP库

\Stripe\Stripe::setApiKey('YOUR_SECRET_KEY'); // 设置您的Stripe密钥

$accountId = 'acct_1234567890abcdef'; // 替换为上一步创建的Express账户ID

try {
    $accountLink = \Stripe\AccountLink::create([
        'account' => $accountId, // 关联的Express账户ID
        'refresh_url' => 'https://example.com/reauth', // 当链接过期或用户需要重新认证时，Stripe将重定向到此URL
        'return_url' => 'https://example.com/return', // 用户完成入驻流程后，Stripe将重定向到此URL
        'type' => 'account_onboarding', // 链接类型，指定用于账户入驻
    ]);
    echo "账户链接生成成功，URL: " . $accountLink->url;
} catch (\Stripe\Exception\ApiErrorException $e) {
    echo "生成账户链接时发生错误: " . $e->getMessage();
}
?>

参数说明：

• account: 必须指定要为其生成链接的Express账户ID。
• refresh_url: 用户在Stripe入驻页面停留时间过长导致链接过期，或Stripe出于安全原因要求重新认证时，Stripe会将用户重定向到此URL。您应在此URL处重新生成并引导用户跳转至新的账户链接。
• return_url: 用户成功完成Stripe入驻流程后，Stripe会将用户重定向到此URL。您可以在此页面向用户展示入驻成功的消息。
• type: 必须设置为 'account_onboarding'，表明此链接用于账户入驻。

重要提示：

• 生成的账户链接是短时有效的（通常持续几分钟）。一旦用户访问或链接过期，它将失效。每次用户需要访问入驻流程时，都应重新生成。
• refresh_url 和 return_url 的设置对于提供良好的用户体验和处理边缘情况至关重要。

步骤三：引导用户完成入驻

最后一步是将用户重定向到上一步生成的 accountLink->url。用户点击或被重定向到此URL后，将进入Stripe托管的入驻页面，完成银行信息、身份验证等必要步骤。

示例代码 (PHP):

<?php
// 假设 $accountLink->url 是从上一步获取的
$onboardingUrl = $accountLink->url;

// 将用户重定向到Stripe的入驻页面
header("Location: " . $onboardingUrl);
exit();
?>

用户体验流程：

1. 用户在您的平台点击“连接Stripe”或类似按钮。
2. 您的后端调用Stripe API创建Express账户。
3. 您的后端调用Stripe API生成账户链接。
4. 您的后端将用户重定向到生成的账户链接。
5. 用户在Stripe托管页面完成入驻信息填写。
6. 用户完成入驻后，Stripe将其重定向回您在 return_url 中指定的页面。
7. 如果链接过期，用户将被重定向到 refresh_url，您的平台应在此处重新生成链接并引导用户。

总结

通过遵循Stripe Connect Express账户的现代化集成流程，即“创建Express账户 -> 生成账户链接 -> 引导用户跳转”，开发者能够以安全、高效且符合Stripe最新推荐的方式，为第三方用户提供无缝的入驻体验。这种方法提供了对账户生命周期的显式控制，并利用Stripe托管的UI来处理复杂的合规性要求，极大地简化了平台侧的开发工作。务必确保您的Stripe API密钥安全，并妥善处理 refresh_url 和 return_url 的逻辑，以提供健壮的用户体验。

以上就是Stripe Connect Express账户集成指南：现代化API流程详解的详细内容，更多请关注php中文网其它相关文章！