Correction de bugs et amélioration de la latence pour les sessions Checkout en mode abonnementModifications majeures

Nouveautés

Cette version offre une latence améliorée sur toutes les API Checkout Session pour les sessions en mode abonnement, y compris lorsque votre client confirme la session.

Elle corrige également un bogue des versions antérieures qui empêchait vos clients de mettre à jour une session après la première tentative de paiement, par exemple l’impossibilité de modifier une adresse de facturation. Ils peuvent maintenant procéder eux-mêmes au déblocage au lieu de devoir réactualiser.

Pourquoi s’agit-il d’une modification majeure ?

Étant donné que cette modification crée l’abonnement après que l’utilisateur a effectué le paiement, la payment_intent ne fait référence à une facture qu’une fois la session Checkout terminée. Cela signifie que la propriété checkout.session.status doit être réglée sur complete avant que la facture soit créée.

Si votre intégration repose actuellement sur une facture lors des webhooks d’intention de paiement, nous vous recommandons de mettre à jour votre intégration pour utiliser à la place le webhook checkout_session.completed, qui vérifie la présence d’une facture.

Impact

• Les abonnements sont désormais créés une fois que l’utilisateur a effectué le paiement.
• Les tentatives de paiement échouées ne se traduisent plus par un abonnement incomplet avec une facture finalisée.
• Aucune facture n’est présente tant que la session de paiement n’est pas à l’état complete.

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

Mise à niveau