使用 Stripe API (PHP) 删除客户账户-php教程-PHP中文网

使用 Stripe API (PHP) 删除客户账户

DDD

发布： 2025-10-17 10:11:32

原创

346人浏览过

使用 stripe api (php) 删除客户账户

本文档介绍了如何使用 Stripe API 在 PHP 中删除客户账户。由于 Stripe PHP 库版本更新，删除客户的方法有所不同。本文将针对不同版本提供相应的代码示例，帮助开发者选择合适的删除方式，并避免常见的 API 调用错误。

删除客户账户的方法

Stripe PHP 库提供了删除客户账户的功能，但具体实现方式取决于你使用的库版本。在 7.33.0 版本之前，你需要先检索客户信息，然后才能调用 delete() 方法。而在 7.33.0 及更高版本中，你可以直接调用 delete() 方法删除客户。

适用于 stripe-php 7.33.0 之前的版本

在这些版本中，你需要先使用 \Stripe\Customer::retrieve() 方法检索客户信息，然后再调用 delete() 方法。

require APPPATH .'third_party/stripe-php/init.php';
\Stripe\Stripe::setApiKey('YOUR_STRIPE_SECRET_KEY');

$customer = \Stripe\Customer::retrieve('cus_XXX'); // 替换为你要删除的客户 ID
$customer->delete();

echo "Customer deleted successfully!";

登录后复制

注意事项：

立即学习“PHP免费学习笔记（深入）”；

JoinMC智能客服

JoinMC智能客服，帮您熬夜加班，7X24小时全天候智能回复用户消息，自动维护媒体主页，全平台渠道集成管理，电商物流平台一键绑定，让您出海轻松无忧！

查看详情

确保替换 'cus_XXX' 为你要删除的实际客户 ID。
确保已经正确设置了 Stripe API 密钥。
这种方法需要两次 API 调用：一次用于检索客户信息，一次用于删除客户。

适用于 stripe-php 7.33.0 及更高版本

Stripe 在 7.33.0 版本引入了 StripeClient，允许你直接调用 delete() 方法，无需先检索客户信息。

require APPPATH .'third_party/stripe-php/init.php';

$stripe = new \Stripe\StripeClient('YOUR_STRIPE_SECRET_KEY');

$stripe->customers->delete(
  'cus_XXX', // 替换为你要删除的客户 ID
  [] // 可选参数，例如 `prune_source`
);

echo "Customer deleted successfully!";

登录后复制

注意事项：

立即学习“PHP免费学习笔记（深入）”；

确保替换 'cus_XXX' 为你要删除的实际客户 ID。
确保已经正确设置了 Stripe API 密钥。
[] 是一个可选的关联数组，可以传递额外的参数。例如，你可以使用 prune_source 参数来删除客户的默认付款方式。

示例：使用 prune_source 参数

require APPPATH .'third_party/stripe-php/init.php';

$stripe = new \Stripe\StripeClient('YOUR_STRIPE_SECRET_KEY');

$stripe->customers->delete(
  'cus_XXX',
  ['prune_source' => true] // 删除客户的默认付款方式
);

echo "Customer deleted successfully!";

登录后复制

错误处理

在调用 Stripe API 时，可能会遇到各种错误。为了保证程序的健壮性，你应该添加适当的错误处理机制。

require APPPATH .'third_party/stripe-php/init.php';

try {
    $stripe = new \Stripe\StripeClient('YOUR_STRIPE_SECRET_KEY');

    $stripe->customers->delete(
        'cus_XXX',
        []
    );

    echo "Customer deleted successfully!";

} catch (\Stripe\Exception\ApiErrorException $e) {
    // 处理 Stripe API 错误
    echo "Error deleting customer: " . $e->getMessage();
} catch (Exception $e) {
    // 处理其他错误
    echo "An unexpected error occurred: " . $e->getMessage();
}

登录后复制

常见的 Stripe API 错误：

InvalidRequestError: 请求参数无效。
AuthenticationError: API 密钥无效。
RateLimitError: 请求频率过高。
CardError: 信用卡信息无效。

总结

本文介绍了如何使用 Stripe API 在 PHP 中删除客户账户。你需要根据你使用的 Stripe PHP 库版本选择合适的删除方法。同时，你应该添加适当的错误处理机制，以保证程序的健壮性。记住替换示例代码中的占位符，例如 'cus_XXX' 和 'YOUR_STRIPE_SECRET_KEY' 为实际的值。通过本文的指导，你可以安全有效地删除 Stripe 客户账户。

以上就是使用 Stripe API (PHP) 删除客户账户的详细内容，更多请关注php中文网其它相关文章！