Paiements récurrents

Si vous avez un modèle économique dans lequel vos clients effectuent des paiements réguliers, il est généralement conseillé de leur proposer des abonnements. Stripe propose plusieurs façons de créer et de gérer des abonnements.

Si vous utilisez Organizations, vous pouvez afficher la liste de vos abonnements sur tous vos comptes. Vous pouvez également filtrer cette liste par compte. Toutefois, vous ne pouvez créer et analyser des abonnements qu’à partir de la page Abonnements au niveau du compte.

Créer des abonnements à partir du Dashboard

Pour créer un abonnement :

1. Dans le Dashboard Stripe, accédez à la page Abonnements.

2. Cliquez sur +Créer un abonnement.

3. Sélectionnez ou ajoutez un client.

4. Saisissez les informations relatives aux tarifs et aux produits (vous pouvez ajouter plusieurs produits).

5. Définissez les dates de début et de fin d’abonnement.

6. Configurez la date de début du cycle de facturation, qui définit quand la facture suivante sera générée. En fonction de vos paramètres, le moyen de paiement enregistré pourra également être débité automatiquement à cette date. En savoir plus sur la date du cycle de facturation.

7. (Recommandé) Configurez les rappels et notifications par e-mail pour les abonnés.

8. (Facultatif) Ajoutez un régime de taxe par défaut, un bon de réduction, une offre d’essai gratuit ou des métadonnées.

9. (Facultatif) Activez les fonctionnalités de recouvrement automatique dans le Dashboard pour réduire et résoudre les échecs de paiement d’abonnement. Vous pouvez relancer automatiquement les paiements qui ont échoué, créer des automatisations personnalisées, configurer l’envoi d’e-mails aux clients, et bien plus encore.

Créer des abonnements avec Payment Links

Pour créer des abonnements avec Payment Links, sélectionnez Vendre un abonnement lorsque vous créez le lien de paiement. Partagez ensuite le lien avec vos clients. En savoir plus sur la création et le partage des liens de paiement.

Créer des abonnements avec Checkout

Si vous utilisez Checkout comme votre interface utilisateur de paiement, créez des abonnements avec l’API Checkout Sessions. Dans une intégration typique, vous ajoutez un bouton à votre site qui appelle le back-end de votre application pour créer la session Checkout. Consultez le guide d’intégration des abonnements pour en savoir plus.

Une fois le paiement abouti, l’abonnement devient actif et l’objet Checkout Session contient des références aux objets Customer et Subscription.

Pour créer un abonnement avec cet API, transmettez mode=subscription :

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

# The price ID passed from the front end.
#   price_id = params['priceId']
price_id = '{{PRICE_ID}}'

session = Stripe::Checkout::Session.create({
  success_url: 'https://example.com/success.html?session_id={CHECKOUT_SESSION_ID}',
  cancel_url: 'https://example.com/canceled.html',
  mode: 'subscription',
  line_items: [{
    # For usage-based billing, don't pass quantity
    quantity: 1,
    price: price_id,
  }],
  subscription_data: {
    billing_mode: { type: 'flexible' }
  }
})

# Redirect to the URL returned on the session
#   redirect session.url, 303

Créer des abonnements avec Elements

Si vous utilisez Elements comme votre interface utilisateur de paiement, créez des abonnements à l’aide de l’API Subscriptions.

Transmettez l’ID du tarif et l’ID du dossier client au back-end. Ensuite, dans le back-end, créez l’abonnement à l’état incomplete à l’aide de payment_behavior=default_incomplete. Renvoyez ensuite le client_secret du premier PaymentIntent de l’abonnement vers votre front-end afin d’effectuer le paiement. Découvrez comment créer une intégration d’abonnements avec Elements.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

post '/create-subscription' do
  content_type 'application/json'
  data = JSON.parse(request.body.read)
  customer_id = cookies[:customer]
  price_id = data['priceId']

  # Create the subscription. Note we're expanding the Subscription's
  # latest invoice and that invoice's confirmation_secret
  # so we can pass it to the front end to confirm the payment
  subscription = Stripe::Subscription.create(
    customer: customer_id,
    items: [{
      price: price_id,
    }],
    payment_behavior: 'default_incomplete',
    payment_settings: {save_default_payment_method: 'on_subscription'},
    billing_mode: {type: 'flexible'},
    expand: ['latest_invoice.confirmation_secret']
  )

  { subscriptionId: subscription.id, clientSecret: subscription.latest_invoice.confirmation_secret.client_secret }.to_json
end

À ce stade, l’abonnement est inactive et en attente de paiement. Dans l’exemple de réponse suivant, les champs à sauvegarder impérativement sont en surbrillance. Nous vous recommandons de sauvegarder également tous les champs auxquels votre application accède fréquemment.

{
  "id": "sub_JgRjFjhKbtD2qz",
  "object": "subscription",
  "application_fee_percent": null,
  "automatic_tax": {
    "disabled_reason": null,
    "enabled": false,
    "liability": "null"
  },
  "billing_cycle_anchor": 1623873347,

Créer des abonnements via l’API Subscriptions

Utilisez l’API Subscriptions pour créer des abonnements de base pour les tarifs récurrents. Découvrez comment créer une intégration d’abonnements de bout en bout ou utiliser le guide de démarrage immersif.

Voici la marche à suivre pour créer un abonnement dont le paiement initial comprend également un achat ponctuel (comme des frais de service) :

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"={{RECURRING_PRICE_ID}} \
  -d "add_invoice_items[0][price]"={{ONE_TIME_PRICE_ID}}

Créer des abonnements avec l’API Subscription Schedules

Pour les scénarios d’abonnement plus complexes, utilisez l’API Subscription Schedules. En savoir plus sur les planifications d’abonnement et leurs cas d’usage.

Comment créer un abonnement récurrent :

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=cus_Gk0uVzT2M4xOKD \
  -d "items[0][price]"=price_F52b2UdntfQsfR \
  -d "expand[0]"="latest_invoice.payments" \
  -d "expand[1]"="latest_invoice.confirmation_secret" \
  -d off_session=true

Configurez des paiements récurrents en débitant le moyen de paiement enregistré d’un client. Capturez les informations de paiement à l’aide d’un PaymentIntent ou d’un SetupIntent. Utilisez ensuite la clé secrète du client associée à ces objets pour débiter le client au moment voulu. Cette approche est recommandée si vous ne souhaitez pas utiliser Subscriptions ou si vous avez implémenté votre propre logique d’abonnement. Ces étapes ne couvrent que les opérations nécessaires pour collecter les informations concernant le moyen de paiement et le débiter. Consultez le guide pour connaître tous les détails de l’intégration d’enregistrement et de réutilisation des informations de paiement.

• Utilisez PaymentIntents pour capturer les informations de paiement au cours d’un tunnel de paiement. Débitez vos clients en session pour un paiement immédiat, puis débitez-les ultérieurement. Ce tunnel est idéal pour facturer aux clients un premier paiement d’une série de paiements récurrents, ou facturer des frais d’installation ponctuels pour un service d’abonnement.
• Utilisez SetupIntents pour capturer les informations de paiement en dehors d’un tunnel de paiement. Recueillez les informations auprès du client et sauvegardez-les dans un SetupIntent. Ce tunnel est idéal pour capturer les informations de paiement lorsque vous intégrez un client que vous avez l’intention de facturer plus tard, ou pour configurer des essais gratuits.

Vous pouvez utiliser les factures pour gérer les paiements récurrents. Par exemple, l’entreprise Powdur propose un service d’entretien paysager mensuel. Chaque mois, les paysagistes adressent une facture à Powdur et débitent automatiquement le paiement via le moyen de paiement qu’ils ont enregistré pour Powdur.

Les sections suivantes décrivent les possibilités d’utilisation des factures pour les paiements récurrents.

Créer une facture via le Dashboard

Pour créer et envoyer une facture, suivez les étapes ci-après :

1. Dans le Dashboard, accédez à la page Factures, puis cliquez sur Créer une facture pour ouvrir l’éditeur de factures. Chaque fois que vous quittez l’éditeur de factures, Stripe enregistre un brouillon. (Pour supprimer un brouillon de facture, cliquez sur le menu de débordement () qui se trouve en regard d’une facture sur la page Factures.)

2. Sélectionnez un client existant ou cliquez sur Ajouter un nouveau client. Pour les nouveaux clients, vous devez saisir un nom. Vous pouvez ajouter une adresse e-mail ou d’autres informations.

3. (Facultatif) Cliquez sur le menu déroulant de débordement () dans la section Postes pour ouvrir la boîte de dialogue Options des postes de facture. Choisissez la devise et l’option d’affichage des taxes souhaitées pour la facture.

4. Sélectionnez Ajouter un poste ponctuel afin de créer un article pour une utilisation unique. Pour enregistrer un produit pour une utilisation future, sélectionnez Créer un produit.

5. Saisissez la Quantité et le Tarif de votre nouvel article ou de votre nouveau produit.

6. (Facultatif) Cliquez sur les Options de postes de facture sous chaque poste pour ajouter un taux de taxe, un bon de réduction ou une date de livraison. Vous pouvez également utiliser le Dashboard pour créer un taux de taxe ou un bon de réduction.

7. (Facultatif) Utilisez la zone Mémo pour fournir des informations supplémentaires à votre client. Vous pouvez modifier le mémo sur une facture en cliquant sur le bouton Modifier le mémo sur la page des informations correspondante.

8. Sélectionnez l’une des options de livraison de la facture suivantes :

   • Débiter automatiquement un moyen de paiement enregistré : débite immédiatement du montant de la facture le moyen de paiement du client que vous avez enregistré.

   • Envoyer la facture ou le lien vers la page de paiement manuellement : génère un lien de paiement que vous pouvez envoyer à votre client après confirmation de la facture.

   • Envoyer la facture par e-mail avec lien de paiement : Stripe enverra au client un e-mail contenant un PDF de sa facture ainsi qu’un lien vers une page de paiement

   • Envoyer la facture par e-mail sans lien de paiement : Stripe enverra au client un e-mail contenant uniquement un PDF de sa facture.

9. (Facultatif) Pour planifier la finalisation automatique de cette facture à une date ultérieure, sélectionnez Planifier la date d’envoi. Selon ce que vous avez sélectionné à l’étape précédente, vous pouvez également choisir Planifier la date de paiement ou Planifier la date de finalisation.

10. (Facultatif) Développez les Options avancées et ajoutez des champs personnalisés. Pour en savoir plus, consultez la page Tarifs nets et taxes. Développez les Options avancées et ajoutez des champs personnalisés.

11. Cliquez sur Vérifier la facture et choisissez d’intégrer des e-mails supplémentaires ou de poursuivre la modification de la facture. Envoyez la facture.

Créer une facture via l’API

Vous pouvez créer une facture via l’API Invoices. Avant de créer une facture, vous devez créer les produits, tarifs et client adéquats, car ces valeurs devront être spécifiées dans la facture et les postes de facture. Lisez notre guide pour découvrir comment intégrer l’API Invoicing, ou consultez le guide de démarrage rapide pour une expérience immersive et centrée sur le code.

Pour créer une facture à l’aide de l’API, suivez les étapes ci-dessous :

Définissez l’attribut collection_method sur send_invoice. Pour que Stripe soit en mesure de marquer une facture comme étant en retard, renseignez le paramètre days_until_due. Stripe envoie au client la facture et des instructions de paiement par e-mail.

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d collection_method=send_invoice \
  -d days_until_due=30

Ensuite, créez un poste de facture en transmettant l’id du client, le price du produit et la invoice de l’ID de la facture.

Le nombre maximal de postes de facture est de 250.

curl https://api.stripe.com/v1/invoiceitems \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "pricing[price]"=
{{PRICE_ID}} \
  -d invoice=
{{INVOICE_ID}}

Lorsque vous définissez auto_advance sur false, vous pouvez continuer à modifier la facture jusqu’à sa finalisation. Pour finaliser un brouillon de facture, utilisez le Dashboard, envoyez la facture au client ou déclenchez son règlement. Vous pouvez également utiliser l’API Finalize :

curl -X POST https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
/finalize \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Planifier les factures récurrentes

Si vous souhaitez configurer une facture récurrente, créez un abonnement.

Vous pouvez choisir comment encaisser le paiement :

• Envoyer une facture au client. Vous pouvez définir les conditions d’encaissement, notamment la date d’échéance et les moyens de paiement acceptés.
• Débiter automatiquement un moyen de paiement enregistré. Si le client dispose d’un moyen de paiement enregistré, Stripe débite automatiquement ce moyen de paiement.

Dans le Dashboard, vous définissez l’encaissement des paiements dans l’éditeur d’abonnements. Dans l’API, vous définissez l’encaissement des paiements avec le paramètre collection_method.

Vous pouvez également configurer Stripe pour qu’il envoie aux clients des e-mails de rappel concernant les factures récurrentes impayées.

Stripe génère automatiquement une facture pour chaque cycle de facturation d’un abonnement. En savoir plus sur le cycle de vie des factures pour les Subscriptions.

Les plans de paiement échelonné permettent aux clients d’effectuer des paiements partiels sur une période déterminée jusqu’à ce que le montant total ait été acquitté. Par exemple, lorsque The Pacific achète de nouvelles presses, elle vend ses anciennes presses à d’autres journaux. Les petits journaux ne disposant généralement pas des fonds suffisants pour régler en une seule fois, un plan de paiement échelonné leur est proposé.

Pour la plupart des presses, The Pacific facture 1 000 € par mois. Un tarif réutilisable est par conséquent créé :

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d unit_amount=100000 \
  -d currency=usd \
  -d product=prod_Hh99apo1OViyGW \
  -d "recurring[interval]"=month

Selon la marque, le modèle et l’âge de la presse, The Pacific facture des montants différents. Dans cet exemple, 1 000 USD sont facturés mensuellement pendant six mois, pour un montant total est de 6 000 USD.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=cancel \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=6

Le nombre d’iterations est multiplié par la période du tarif, qui est égale à 6 paiements mensuels dans cet exemple, pour déterminer le nombre de facturations. Le end_behavior détermine ce qu’il advient de l’abonnement au terme de la dernière itération. Dans un plan de paiement échelonné, l’abonnement n’est alors plus pertinent, et le end_behavior est donc défini sur cancel.

Dans des cas plus rares, The Pacific facture moins que les 1 000 USD habituels par mois. Dans ce cas-là, le service comptable utilise price_data pour créer un tarif à usage unique. Cet exemple crée un tarif de 500 USD avec facturation mensuelle pendant six mois :

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=cancel \
  -d "phases[0][items][0][price_data][currency]"=usd \
  -d "phases[0][items][0][price_data][product]"=prod_Hh99apo1OViyGW \
  -d "phases[0][items][0][price_data][recurring][interval]"=month \
  -d "phases[0][items][0][price_data][unit_amount]"=50000 \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=6

Stripe prend en charge plusieurs moyens de paiement différés. Ces moyens de paiement permettent à vos clients de régler en plusieurs fois. Vous recevez immédiatement la totalité du paiement. Vos clients ne paient rien ou seulement une partie du total de l’achat. Les moyens de paiement différés permettent aux commerçants d’améliorer le taux de conversion, d’augmenter la taille moyenne du panier et d’atteindre de nouveaux clients n’ayant pas de carte bancaire.

En savoir plus sur les moyens de paiement différé

Si votre entreprise est établie au Mexique, vous pouvez proposer à vos clients des versements échelonnés pour les paiements par carte, ou meses sin intereses. Si vous utilisez cette méthode des frais supplémentaires sont ajoutés aux frais de transaction par carte bancaire standard.

Acceptez les versements échelonnés avec une page de paiement hébergée par Stripe (Stripe Checkout), des composants d’interface utilisateur préconfigurés (Stripe Elements), l’API Invoicing ou via Payment Links sans code.

Certains connecteurs et plugins prennent également en charge les versements échelonnés.

Exigences concernant meses sin interes

Tous les types de transactions et de cartes bancaires ne peuvent pas utiliser meses sin intereses. Vous n’avez pas besoin d’implémenter ces règles vous-même. Stripe détermine automatiquement l’éligibilité de meses sin intereses une fois que vous avez défini le moyen de paiement.

• Stripe prend en charge les versements échelonnés uniquement pour les comptes Stripe au Mexique.
• Le moyen de paiement doit être une carte bancaire émise au Mexique.
• Il doit s’agir d’une carte personnelle (les cartes d’entreprise ne sont pas prises en charge).
• La carte doit être émise par l’un de nos émetteurs pris en charge.
• La valeur de la devise doit être exprimée en MXN (pesos).
• Le montant total du paiement doit être supérieur à un montant minimum de transaction. Stripe fournit ce montant minimum en se basant sur le nombre de mois dans le plan sélectionné. Vous pouvez spécifier les plans de versements échelonnés que vous souhaitez activer, et personnaliser vos montants de transaction minimum et maximum en configurant les paramètres de versements échelonnés personnalisés dans le Dashboard.

1. Dans le Dashboard Stripe, activez le lien vers le portail client sur la page des paramètres du portail client.
2. Sur la même page, passez en revue les options de configuration du portail client. Configurez le portail client sans écrire de code. En savoir plus sur toutes les options de configuration.
3. Partagez le lien vers le portail avec vos clients.
4. Optional Personnalisez l’image de marque et préremplissez les adresses e-mail en ajoutant le paramètre URL prefilled_email au lien vers le portail.

1. Dans le Dashboard Stripe, créez un lien de paiement.
2. Sélectionnez Produits ou abonnements.
3. Recherchez ou ajoutez un produit récurrent qui représente le don récurrent.
4. Dans Options avancées, faites passer l’option d’appel à l’action sur Faire un don.
5. Créez le lien et partagez-le. Vous pouvez partager le lien directement, l’intégrer en tant que bouton sur votre site ou générer un code QR.
6. Suivez les paiements associés au lien de paiement dans l’aperçu des paiements du Dashboard.

En savoir plus sur la création et le partage de liens de paiement.