Stripe Webhook。处理多个 Webhook 事件

Question

我在使用 Stripe Webhooks 时遇到问题，尤其是 payment_intent.processing 事件。 在我必须维护的旧应用程序中，我们使用 3 种付款方式。其中之一是 SOFORT 支付。这种付款方式的主要区别在于，您应该等待几天的银行响应，然后从 Stripe Webhook 获得 Payment Succeeded 响应。但我们的应用程序要求我们在客户付款时立即填写客户余额。 SOFORT 值得信赖，我们从未遇到过交易在处理过程中被取消的情况。

但是 2 天前，我遇到了一个新问题，当时 stripe 创建了两个间隔为 1 秒的 payment_intent.processing 事件，并且客户在其余额中获得了 2 次积分。 这是一段代码来解释我的意思：

$paymentIntent = $event->data->object;
$order = Db_Orders::getOrderPaymentIntentId($paymentIntent->id);
switch ($event->type) {
case 'payment_intent.processing':
    if ($order['wlo_payment_type'] == PAYMENT_METHOD_SOFORT && $order['wlo_status'] == W_LEADS_ORDER_STATUS_STARTED) Utils::activateOrderOffers($order['id']);
    $orderObj = new Db_LeadOrder();
    $orderObj->id = $order['id'];
    $orderObj->wlo_status = W_LEADS_ORDER_STATUS_PENDING;
    $orderObj->save();
    break;
case 'payment_intent.succeeded':
    if ($order['wlo_payment_type'] != PAYMENT_METHOD_SOFORT && $order['wlo_status'] != W_LEADS_ORDER_STATUS_SUCCESS) Utils::activateOrderOffers($order['id']);
    $orderObj = new Db_LeadOrder();
    $orderObj->id = $order['id'];
    $orderObj->wlo_response_date = Utils::formatDateDb(time());
    $orderObj->wlo_status = W_LEADS_ORDER_STATUS_SUCCESS;
    $orderObj->save();
    break;
  default:
    echo 'Received unknown event type ' . $event->type;

在 activateOrderOffers 函数中，我使用客户余额进行所有操作。正如您在 payment_intent.processing 事件中看到的那样，我仅针对处于 STARTED（所有订单的初始状态）状态的 SOFORT 付款方式执行该操作。

据我了解，就我而言，我正在侦听两个并行处理事件。我是对的吗？有什么想法可以解决这个问题吗？我知道，在付款尚未成功时操纵余额可能是一种不好的做法，但这是客户的主要要求。 向大家致以最诚挚的问候。

Answer 1

Stripe Webhook 可能会重新发送事件。根据最佳实践，您可以考虑记录已收到的事件。

https://docs.stripe.com/webhooks#handle-duplicate-events

Webhook 端点有时可能会多次接收同一事件。我们建议您通过使事件处理幂等来防止重复的事件接收。一种方法是记录您已处理的事件，然后不处理已记录的事件。

Answer 2

虽然不太可能，但可能会发送同一事件的多个副本，因此您需要使您的 webhook 处理代码具有幂等性，以便正确处理该问题。