Mise en attente des mises à jour

Vous pouvez mettre des mises à jour en attente avec les appels de modification d’abonnement, de création de poste d’abonnement et de modification de poste d’abonnement. Lorsque vous effectuez la mise à jour, définissez le paramètrepayment_behavior=pending_if_incomplete. L’exemple ci-dessous illustre l’ajout d’un nouveau tarif à un abonnement. Puisque proration_behavior=always_invoice est spécifié, une facture est créée et le paiement est tenté lors de la mise à jour.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_behavior"="pending_if_incomplete" \
  -d "proration_behavior"="always_invoice" \
  -d "items[0][id]"="si_09IkI4u3ZypJUk5onGUZpe8O" \
  -d "items[0][price]"="price_CBb6IXqvTLXp3f"

Si le paiement réussit, l’abonnement est mis à jour. Si le paiement échoue, l’objet Subscription renvoyé contient un hachage pending_update avec les modifications :

{
  "id": "sub_49ty4767H20z6a",
  "object": "subscription",
  "application_fee_percent": null,
  "pending_update": {
    "expires_at": 1571194285,
    "subscription_items": [
      {
        "id": "si_09IkI4u3ZypJUk5onGUZpe8O",
        "price": "price_CBb6IXqvTLXp3f"
      }
    ]
  },
}

Après avoir effectué la mise à jour, vérifiez le hachage pending_update au niveau de l’abonnement. Si vous voulez être informé automatiquement, vous pouvez créer un webhook qui écoute l’événement customer.subscription.updated. Si le hachage pending_update est renseigné, le paiement échoue et le cycle de l’abonnement se poursuivra comme si aucune demande de mise à jour n’avait été effectuée.

Les paiements échouent souvent parce que le moyen de paiement est refusé ou parce qu’une authentification client est demandée. Vous devez créer une logique pour gérer ces deux scénarios.

Utilisez les instructions pour les échecs de paiement afin de gérer les refus de carte. Vous devez joindre un nouveau moyen de paiement au client, puis utiliser l’endpoint de paiement pour payer la facture générée par la mise à jour.

Utilisez les instructions de l’action client pour gérer l’authentification client. Cela permettra d’assister l’utilisateur dans le processus d’authentification, jusqu’à ce qu’il règle la facture.

Un paiement réussi :

• Applique immédiatement les modifications dans le hachage pending_update.
• Met à jour la facture sur paid.

Si le paiement échoue à nouveau, le hachage pending_update reste dans l’abonnement avec la date d’expiration d’origine et aucune modification n’est appliquée.