Gérer un stock limité

Pour certains types d’entreprises aux stocks limités, vous devez empêcher les clients de réserver des articles pour une longue période sans finaliser l’achat. Par exemple, un vendeur de billets pour un événement doit accorder quelques minutes à ses clients pour acheter les billets qu’ils ont sélectionnés avant d’annuler la vente et de rendre ces billets à nouveau disponibles. Vous pouvez annuler une vente en attente en faisant expirer la session Checkout.

Checkout prend en charge en charge l’expiration manuelle et programmée des sessions. Lorsqu’une session de paiement expire, sa propriété d’état prend la valeur expired.

Expiration manuelle

Pour faire expirer immédiatement une session Checkout ouverte et annuler tout achat en attente, utilisez l’endpoint expire.

curl -X POST https://api.stripe.com/v1/checkout/sessions/
{{SESSION_ID}}
/expire \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Définir une heure d’expiration

Lorsque vous créez une session Checkout, spécifiez un horodatage d’expiration en définissant le paramètre expires_at. La valeur doit être comprise entre 30 minutes et 24 heures après l’heure actuelle. Si vous ne spécifiez pas expires_at, la valeur par défaut est 24 heures après l’heure actuelle.

curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}} \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d success_url="https://example.com/success" \
  -d expires_at="{{NOW_PLUS_TWO_HOURS}}"

Réintégrer des articles à votre inventaire

Lorsqu’une session Checkout expire, Stripe envoie l’événement checkout.session.expired. Configurez votre endpoint de webhook pour écouter cet événement de sorte que votre gestionnaire de webhook puisse réintégrer aux stocks les articles réservés dans la session arrivée à expiration. Pour en savoir plus, consultez Faire expirer une session.