Modifier les informations de paiement

Pour commencer, il vous faut un compte Stripe. Créez un compte.

Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre application :

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Pour créer une session en mode configuration, utilisez le paramètre mode défini sur setup lors de la création de la session. Vous trouverez la liste complète des paramètres utilisables pour la création d’une session dans la documentation relative à l’API sur les sessions Checkout.

Associez la variable de modèle {CHECKOUT_SESSION_ID} à l’URL success_url afin d’obtenir l’ID de session une fois que votre client a terminé sa session Checkout.

Enfin, utilisez le dictionnaire setup_intent_data.metadata pour transmettre le paramètre subscription_id Stripe existant de votre client à la session Checkout. Bien qu’il existe d’autres méthodes pour transmettre ces données à votre serveur, nous utiliserons dans ce guide les métadonnées.

curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "payment_method_types[]"="card" \
  -d "mode"="setup" \
  -d "customer"="cus_FOsk5sbh3ZQpAU" \
  -d "setup_intent_data[metadata][subscription_id]"="sub_8epEF0PuRhmltU" \
  -d "success_url"="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "cancel_url"="https://example.com/cancel"

Checkout s’appuie sur Stripe.js, la bibliothèque JavaScript de Stripe, pour créer des tunnels de paiement.

npm install @stripe/stripe-js

import {loadStripe} from '@stripe/stripe-js';

const stripe = await loadStripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx');

const checkoutButton = document.getElementById('checkout-button');

checkoutButton.addEventListener('click', () => {
  stripe.redirectToCheckout({
    // Make the id field from the Checkout Session creation API response
    // available to this file, so you can provide it as argument here
    // instead of the {{CHECKOUT_SESSION_ID}} placeholder.
    sessionId: '{{CHECKOUT_SESSION_ID}}'
  })
  // If `redirectToCheckout` fails due to a browser or network
  // error, display the localized error message to your customer
  // using `error.message`.
});

Ce code est généralement appelé depuis un gestionnaire d’événements qui se déclenche suite à une action de votre client, par exemple un clic sur le bouton de paiement.

Une fois que votre client a terminé sa session Checkout, vous devez récupérer l’objet session. Il y a deux façons de procéder :

• De manière asynchrone : en traitant les webhooks checkout.session.completed, qui contiennent un objet session. En savoir plus sur la configuration des webhooks.
• De manière synchrone : obtenez l’ID de session à partir de l’URL success_url lorsqu’un utilisateur est redirigé vers votre site. Utilisez l’ID de session pour récupérer l’objet de session.

curl https://api.stripe.com/v1/checkout/sessions/cs_test_MlZAaTXUMHjWZ7DcXjusJnDU4MxPalbtL5eYrmS2GKxqscDtpJq8QM0k \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Le choix entre ces deux méthodes dépend de votre tolérance aux abandons de paiement. En effet, il peut arriver que vos clients n’arrivent pas à l’URL success_url après la réussite d’un paiement. Ils peuvent par exemple fermer l’onglet de leur navigateur avant d’être correctement redirigés. Si votre intégration traite les webhooks, elle ne sera pas exposée à ce type d’abandon de paiement.

Après avoir récupéré l’objet session, obtenez la valeur de la clé setup_intent, qui correspond à l’ID du SetupIntent créé lors de la session Checkout. Un SetupIntent est un objet permettant de configurer les coordonnées de compte bancaire de votre client en vue de paiements futurs.

Exemple de charge utile checkout.session.completed :

{
  "id": "evt_1Ep24XHssDVaQm2PpwS19Yt0",
  "object": "event",
  "api_version": "2019-03-14",
  "created": 1561420781,
  "data": {
    "object": {
      "id": "cs_test_MlZAaTXUMHjWZ7DcXjusJnDU4MxPalbtL5eYrmS2GKxqscDtpJq8QM0k",
      "object": "checkout.session",
      "billing_address_collection": null,
      "client_reference_id": null,
      "customer": "cus_FOsk5sbh3ZQpAU",
      "customer_email": null,
      "display_items": [],
      "mode": "setup",
      "setup_intent": "seti_1EzVO3HssDVaQm2PJjXHmLlM",
      "submit_type": null,
      "subscription": null,
      "success_url": "https://example.com/success"
    }
  },
  "livemode": false,
  "pending_webhooks": 1,
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "type": "checkout.session.completed"
}

Prenez note de l’ID du setup_intent pour la prochaine étape.

À l’aide de l’ID de setup_intent, récupérez l’objet SetupIntent à l’aide de l’endpoint /v1/setup_intents/:id.

curl https://api.stripe.com/v1/setup_intents/seti_1EzVO3HssDVaQm2PJjXHmLlM \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Exemple de réponse :

{
  "id": "seti_1EzVO3HssDVaQm2PJjXHmLlM",
  "object": "setup_intent",
  "application": null,
  "cancellation_reason": null,
  "client_secret": null,
  "created": 1561420781,
  "customer": "cus_FOsk5sbh3ZQpAU",
  "description": null,
  "last_setup_error": null,
  "livemode": false,
  "metadata": {
    "subscription_id": "sub_8epEF0PuRhmltU"
  },
  "next_action": null,
  "on_behalf_of": null,
  "payment_method": "pm_1F0c9v2eZvKYlo2CJDeTrB4n",
  "payment_method_types": [
    "card"
  ],
  "status": "succeeded",
  "usage": "off_session"
}

Notez les ID customer, subscription_id et payment_method en vue des prochaines étapes.

Il existe deux manières de paramétrer l’utilisation d’un moyen de paiement pour les prochaines factures :

• Le configurer en tant que paramètre invoice_settings.default_payment_method de l’objet Customer
• Le configurer en tant que paramètre default_payment_method de l’objet Subscription

Si vous définissez le paramètre invoice_settings.default_payment_method sur l’objet Customer, toutes les factures à venir de ce client seront réglées avec le moyen de paiement spécifié.

Définir le paramètre default_payment_method de l’objet Subscription revient à dire que toutes les factures à venir pour cet abonnement seront réglées avec le moyen de paiement spécifié, et ce, quel que soit le paramètre invoice_settings.default_payment_method défini au niveau de l’objet Customer associé.

Définir le paramètre invoice_settings.default_payment_method de l’objet Customer

À l’aide des ID de client et de PaymentMethod récupérés, définissez le paramètre invoice_settings.default_payment_method de l’objet Customer à partir de l’endpoint /v1/customers/:id.

curl https://api.stripe.com/v1/customers/cus_FOsk5sbh3ZQpAU \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "invoice_settings[default_payment_method]"=pm_1F0c9v2eZvKYlo2CJDeTrB4n

Toutes les factures à venir pour ce client débiteront désormais le nouvel objet PaymentMethod créé à l’aide de la session Checkout du mode configuration.

Définir le paramètre default_payment_method de l’objet Subscription

À l’aide des ID d’abonnement et de PaymentMethod récupérés, définissez le paramètre default_payment_method de l’abonnement à partir de l’endpoint /v1/subscriptions/:id.

curl https://api.stripe.com/v1/subscriptions/sub_8epEF0PuRhmltU \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -X "POST" \
  -d "default_payment_method"="pm_1F0c9v2eZvKYlo2CJDeTrB4n"

Toutes les factures à venir pour cet abonnement débiteront désormais le nouvel objet PaymentMethod créé à l’aide de la session Checkout du mode configuration, et ce, quel que soit le paramètre invoice_settings.default_payment_method de l’objet Customer associé.