Définir des moyens de paiement pour chaque abonnement

Le paramètre payment_settings d’abonnement vous permet de définir des moyens de paiement spécifiques pour un abonnement donné, ce qui offre plus de flexibilité qu’un unique moyen de paiement par défaut default_payment_method ou que les paramètres client moins détaillés.

Pour autoriser des moyens de paiement, vous devez d’abord les activer dans vos paramètres de compte dans le Dashboard Stripe.

Dans certaines situations, des restrictions peuvent empêcher l’utilisation de certains moyens de paiement pour un abonnement. Par exemple, un moyen de paiement peut n’être utilisable que dans une seule devise, ou ne pas prendre en charge les paiements d’un client au-delà d’un certain montant. Stripe ne sélectionne pas automatiquement un moyen de paiement si des restrictions empêchent son utilisation. Pour en savoir plus, consultez la rubrique sur la prise en charge des moyens de paiement.

Sélectionner manuellement des moyens de paiement

Vous pouvez remplacer les moyens de paiement qu’un client peut utiliser pour payer un abonnement en modifiant ses paramètres de paiement.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_settings[payment_method_types][]"=card \
  -d "payment_settings[payment_method_types][]"=customer_balance

Si vous avez défini un moyen de paiement par défaut sur l’objet Customer ou l’objet Subscription, veillez à l’inclure dans la liste des payment_method_types. À défaut, ce moyen de paiement ne sera pas utilisé et le paiement pourrait échouer.

Moyen de paiement prioritaire

Par défaut, une facture générée par un abonnement peut être réglée avec n’importe lequel des moyens de paiement que vous avez autorisés dans votre configuration de méthode de paiement de la facture. Cette configuration prévaut sur celle de l’ancien paramètre client default_source.

Si vous avez défini le paramètre payment_settings.payment_method_types pour un abonnement, celui-ci prime sur les paramètres de facturation par défaut dudit abonnement. Les types de moyens de paiement sont transmis au SetupIntent et aux factures de l’abonnement.

Vous pouvez par ailleurs spécifier un default_payment_method pour l’abonnement, ou utiliser l’ancien paramètre default_source, pour définir le moyen de paiement à utiliser prioritairement.

Lorsque vous activez Enregistrer les informations de paiement du client dans les paramètres de facturation du Dashboard ou dans le paramètre save_default_payment_method de Subscription, tout moyen de paiement utilisé par le client pour régler la facture devient le nouveau moyen par défaut.

Autoriser les clients à mettre à jour leur moyen de paiement

À partir du Dashboard, vous pouvez générer des liens à usage unique permettant aux clients de mettre à jour le moyen de paiement d’un abonnement facturé automatiquement.

Vous pouvez générer un lien de mise à jour à partir de deux endroits :

• Sur la page Détails de l’abonnement de l’abonnement, cliquez sur le menu Actions et sélectionnez Partager le lien de mise à jour des paiements.
• Sur la page Abonnements, recherchez l’abonnement et cliquez sur son menu déroulant (), puis sélectionnez Partager le lien de mise à jour des paiements.

Dans la boîte de dialogue Partager le lien de mise à jour du paiement, vous pouvez envoyer le lien directement au client par e-mail ou le copier pour le partager via un autre moyen. Vous pouvez également désactiver tous les liens de mise à jour de paiement existants pour l’abonnement.

Vous pouvez uniquement générer des liens dans le cadre d’abonnements pour lesquels Billing est défini sur Auto. L’élément de menu ne s’affiche pas dans le cadre des abonnements pour lesquels Billing est défini sur Send.

Les liens de mise à jour des paiements d’abonnement présentent les restrictions suivantes :

• Un lien peut uniquement mettre à jour le moyen de paiement de l’abonnement associé et ne peut pas modifier le moyen de paiement par défaut du client.
• L’état de l’abonnement doit être défini sur active, past_due ou trialing. Il ne peut pas être défini sur unpaid ou terminé.
• Le nouveau moyen de paiement doit être une carte.
• Chaque lien permet au client de mettre à jour ses informations de paiement une seule fois.
• Un lien non utilisé expire au bout de 30 jours.

Erreurs liées aux moyens de paiement

Les erreurs liées aux moyens de paiement peuvent empêcher la création d’un abonnement. Une erreur peut survenir lorsque :

• Vous sélectionnez manuellement un moyen de paiement, mais qu’une restriction (telle qu’une devise non prise en charge), empêche son utilisation.
• Aucun moyen de paiement n’est activé pour votre compte

Des erreurs peuvent également se produire au moment du paiement, empêchant Stripe de finaliser la facture. Pour en savoir plus, veuillez consulter la page consacrée aux erreurs liées aux moyens de paiement en matière de facturation.

Options de moyens de paiement

Certains moyens de paiement proposent des options supplémentaires que vous pouvez configurer pour personnaliser le moyen de paiement d’un client. Pour en savoir plus, veuillez consulter la documentation sur les options des moyens de paiement.