Accepter un paiement

Avant de créer une session Checkout, vous pouvez créer des produits et des prix à l’avance. Utilisez des produits pour représenter différents biens physiques ou niveaux de service, et des prix pour représenter le prix de chaque produit.

Par exemple, vous pouvez créer un T-shirt en tant que produit au prix de 20 USD. Cela vous permet de mettre à jour et d’ajouter des prix sans avoir à modifier les détails de vos produits sous-jacents. Vous pouvez créer des produits et des prix avec le Dashboard ou l’API Stripe. En savoir plus sur le fonctionnement des produits et des tarifs.

curl https://api.stripe.com/v1/products \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name=T-shirt

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d product=
{{PRODUCT_ID}} \
  -d unit_amount=2000 \
  -d currency=usd

Chaque prix que vous créez dispose d’un ID. Lorsque vous créez une session Checkout, faites référence à l’ID du prix et à la quantité. Si vous vendez dans plusieurs devises, affichez votre prix multi-devise. Checkout détermine automatiquement la devise locale du client et présente cette devise si le prix le prend en charge.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=payment \
  -d "line_items[0][price]"={{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  --data-urlencode cancel_url="https://example.com/cancel"

Si vous avez déjà recueilli l’adresse courriel de votre client et que vous souhaitez la faire remplir automatiquement dans la session Checkout, transmettez le paramètre customer_email lors de la création de la session.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode customer_email="customer@example.com" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

Par défaut, les moyens de paiement utilisés pour effectuer un paiement ponctuel avec Checkout ne sont pas disponibles pour une utilisation future.

Enregistrer les moyens de paiement pour les débiter hors session

Vous pouvez configurer Checkout de façon à enregistrer les modes de paiement utilisés pour effectuer des paiements ponctuels en transmettant l’argument payment_intent_data.setup_future_usage. Cela peut notamment vous permettre de capturer un mode de paiement enregistré afin de prélever des frais futurs, comme des frais d’annulation ou de non-présentation.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer_creation=always \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success.html" \
  --data-urlencode cancel_url="https://example.com/cancel.html" \
  -d "payment_intent_data[setup_future_usage]"=off_session

Si vous utilisez Checkout en mode subscription, Stripe enregistre automatiquement le mode de paiement pour le débiter lors des paiements suivants. Les modes de paiement par carte enregistrés pour les clients utilisant les modes setup_future_usage ou subscription ne s’affichent pas dans Checkout pour les achats récurrents (plus d’informations à ce sujet ci-dessous). Nous vous recommandons d’utiliser du texte personnalisé pour rediriger vos clients vers les conditions pertinentes concernant l’utilisation des informations de paiement enregistrées.

Enregistrer les moyens de paiement pour qu’ils soient remplis automatiquement dans Checkout

Par défaut, Checkout utilise Link pour offrir à vos clients la possibilité d’enregistrer et de réutiliser leurs informations de paiement en toute sécurité. Si vous préférez gérer vous-même les modes de paiement, utilisez saved_payment_method_options.payment_method_save lors de la création d’une session Checkout pour permettre à vos clients d’enregistrer leurs modes de paiement pour des achats futurs dans Checkout.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer_creation=always \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success.html" \
  --data-urlencode cancel_url="https://example.com/cancel.html" \
  -d "saved_payment_method_options[payment_method_save]"=enabled

La transmission de ce paramètre en mode paiement ou abonnement affiche une case à cocher facultative qui permet aux clients d’enregistrer explicitement leur mode de paiement pour leurs futurs achats. Lorsque les clients cochent cette case, Checkout enregistre le mode de paiement avec allow_redisplay : always. Checkout utilisera ce paramètre pour déterminer si un mode de paiement peut être rempli automatiquement lors des futurs achats. Lorsque vous utilisez saved_payment_method_options.payment_method_save, vous n’avez pas besoin de transmettre setup_future_usage pour enregistrer le mode de paiement.

L’utilisation de saved_payment_method_options.payment_method_save nécessite un Customer. Pour enregistrer un nouveau client, définissez le paramètre customer_creation de la session Checkout sur always. Sinon, la session n’enregistre, ni le client, ni le mode de paiement.

Si payment_method_save n’est pas transmis ou si le client refuse d’enregistrer le mode de paiement, Checkout enregistre toutefois les modes de paiement créés en mode subscription ou à l’aide de setup_future_usage. La valeur allow_redisplay de ces modes de paiement est définie sur limited. Cela évite qu’ils soient remplis automatiquement pour les achats récurrents, et vous permet de vous conformer aux règles des réseaux de cartes et aux réglementations en matière de protection des données. Découvrez comment modifier le comportement par défaut activé par ces modes et comment modifier ou remplacer le comportement allow_redisplay.

Autoriser les clients à supprimer des modes de paiement enregistrés

Pour permettre à vos clients de supprimer un mode de paiement enregistré afin qu’il ne réapparaisse pas pour des paiements ultérieurs, utilisez saved_payment_method_options.payment_method_remove lors de la création d’une session Checkout.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success.html" \
  --data-urlencode cancel_url="https://example.com/cancel.html" \
  -d "saved_payment_method_options[payment_method_remove]"=enabled

Le client ne peut pas supprimer un mode de paiement s’il est associé à un abonnement actif et qu’aucun mode de paiement par défaut n’est enregistré pour les paiements de factures et d’abonnements.

Stripe prend en charge les paiements par carte en deux temps afin que vous puissiez d’abord autoriser une carte, puis capturer des fonds plus tard. Lorsque Stripe autorise un paiement, l’émetteur de la carte garantit les fonds et retient le montant du paiement sur la carte du client. Vous avez ensuite un certain temps pour capturer les fonds, en fonction de la carte. Si vous ne capturez pas le paiement avant l’expiration de l’autorisation, le paiement sera annulé et l’émetteur libérera les fonds retenus.

La séparation de l’autorisation et de la capture est utile si vous devez prendre des mesures supplémentaires entre la confirmation de la solvabilité du client et la collecte du paiement. Par exemple, si vous vendez des articles dont l’inventaire est limité, vous devrez peut-être vérifier que l’article acheté par votre client avec Checkout est toujours disponible avant de capturer le paiement et de traiter la commande. Pour ce faire, procédez comme suit :

1. Confirmez que Stripe a autorisé le moyen de paiement du client.
2. Consultez votre système de gestion d’inventaire pour vous assurer que l’article est toujours disponible.
3. Mettez à jour votre système de gestion d’inventaire pour indiquer qu’un client a acheté l’article.
4. Capturez le paiement du client.
5. Indiquez au client si l’achat a réussi sur votre page de confirmation.

Pour indiquer que vous voulez séparer l’autorisation de la capture, définissez la valeur de payment_intent_data.capture_method à manual lorsque vous créez la session Checkout. Ainsi, Stripe autorise uniquement le montant sur la carte du client.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"={{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_intent_data[capture_method]"=manual \
  --data-urlencode success_url="https://example.com/success.html" \
  --data-urlencode cancel_url="https://example.com/cancel.html"

Pour capturer un paiement non capturé, vous pouvez utiliser le Dashboard ou le point de terminaison de capture. La capture de paiements par voie programmatique implique d’accéder au PaymentIntent créé lors de la session Checkout, que vous pouvez obtenir à l’aide de l’objet Session.

Laissez vos clients gérer leurs propres comptes en partageant un lien vers votre portail client. Le portail client permet aux clients de se connecter avec leur adresse courriel pour gérer leurs abonnements, mettre à jour leurs modes de paiement et plus encore.