Behebt Fehler und verbessert die Latenz für Checkout-Sitzungen im AbonnementmodusWichtige Änderungen

Das ändert sich

Diese Version bietet eine verbesserte Latenz für alle Checkout Session APIs für Sitzungen im Abonnementmodus, auch wenn Ihre Kundinnen und Kunden die Sitzung bestätigen.

Außerdem wird ein Fehler in früheren Versionen behoben, der Kundinnen und Kunden daran hinderte, eine Sitzung nach dem ersten Zahlungsversuch zu aktualisieren, z. B. wenn eine Rechnungsadresse nicht aktualisiert werden konnte. Sie können sich nun selbst entsperren, anstatt die Sitzung zu aktualisieren.

Warum ist dies eine wichtige Änderung?

Da durch diese Änderung das Abonnement erstellt wird, nachdem die/die Nutzer/in die Zahlung abgeschlossen hat, verweist payment_intent erst auf eine Rechnung, wenn die Checkout-Sitzung vollständig abgeschlossen ist. Das bedeutet, dass die Eigenschaft checkout.session.status complete sein muss, bevor die Rechnung erstellt wird.

Wenn Ihre Integration derzeit auf einer Rechnung während der PaymentIntent-Webhooks basiert, empfehlen wir Ihnen, Ihre Integration so zu aktualisieren, dass stattdessen der Webhook checkout_session.completed verwendet wird, der sicherstellt, dass eine Rechnung vorhanden ist.

Ergebnis

• Abonnements werden jetzt erstellt, nachdem der/die Nutzer/in die Zahlung abgeschlossen hat.
• Fehlgeschlagene Zahlungsversuche führen nicht länger zu einem unvollständigen Abonnement mit finalisierter Rechnung.
• Eine Rechnung ist erst vorhanden, wenn die Checkout-Sitzung den Status complete hat.

require 'json'

# Using Sinatra
post '/webhook' do
  payload = request.body.read
  event = nil

  begin
    event = Stripe::Event.construct_from(
      JSON.parse(payload, symbolize_names: true)
    )
  rescue JSON::ParserError => e
    # Invalid payload
    status 400
    return
  end

  # Handle the event
  case event.type
  when 'payment_intent.succeeded'
    payment_intent = event.data.object # contains a Stripe::PaymentIntent
    # The subscription and invoice might not have been created at this stage.
    # Then define and call a method to handle the successful payment intent.
    # handle_payment_intent_succeeded(payment_intent)
  when 'checkout_session.completed'
    checkout_session = event.data.object # contains a Stripe::CheckoutSession
    # checkout_session.payment_intent is a string here,
    # but you can use this payment_intent token to fetch the associated invoice payment
    # through the /v1/invoice_payments API method and its guaranteed associated invoice
    # and invoice payment are non-null at this stage.
    # Then define and call a method to handle the successful completion of a Checkout Session
    # handle_checkout_session_completed(checkout_session)
  # ... handle other event types
  else
    puts "Unhandled event type: #{event.type}"
  end

  status 200
end

Upgrade