Laravel Cashier添加Stripe支付方式时如何避免重复？

核心问题原因 #

你遇到的报错是因为Laravel Cashier封装的$user->findPaymentMethod()方法自带归属校验，只能查询已经关联到当前用户的支付方式，未关联的支付方式自然会触发权限错误。 #

推荐方案：预查询未关联支付方式的指纹（无需先绑定用户） #

不用先把新支付方式绑定到用户再校验，直接调用Stripe原生API查询新支付方式的指纹即可，你的Stripe密钥有权限查询所有在你平台生成的PaymentMethod，不管是否关联了用户。
实现步骤如下：

1. 查询新支付方式的卡片指纹

// 直接调用Stripe原生SDK获取支付方式详情，无需关联用户
$newPaymentMethod = \Stripe\PaymentMethod::retrieve($request->input('payment_method'));
$newCardFingerprint = $newPaymentMethod->card->fingerprint;

2. 对比用户已有支付方式的指纹

// 取出当前用户所有已绑定银行卡的指纹
$existsFingerprints = $user->paymentMethods()->map(fn($paymentMethod) => $paymentMethod->card->fingerprint);

// 校验重复，存在则直接返回错误
if ($existsFingerprints->contains($newCardFingerprint)) {
    return response()->json([
        'message' => '该银行卡已绑定至当前账户，请不要重复添加'
    ], 422);
}

3. 无重复再执行后续绑定逻辑
   校验通过后，再把新支付方式添加到用户账户、设置为默认支付方式即可，全程不会产生多余的绑定/删除操作。

原有先绑定后删除方案的问题 #

• 会产生多余的Stripe操作日志，后期排查问题容易混淆
• 高并发场景下可能出现重复绑定、漏删的问题
• 特殊情况下如果删除操作执行失败，会导致用户账户下出现重复的支付方式

内容的提问来源于stack exchange，提问作者Nite