Définir des moyens de paiement pour chaque abonnement
Le paramètre d’abonnement payment_settings
vous permet de définir des moyens de paiement spécifiques pour un abonnement donné, offrant 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 certains cas, des restrictions peuvent empêcher l’utilisation de moyens de paiement donnés 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 règlements au-delà d’un certain montant. Stripe ne sélectionne pas automatiquement le moyen de paiement considéré lorsque de telles restrictions empêchent son utilisation.
Sélectionner manuellement des moyens de paiement
Vous pouvez remplacer les moyens de paiement utilisables pour payer un abonnement en modifiant ses paramètres de paiement.
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 pourra é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 vos paramètres du modèle de 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.
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 plus de détails, consultez 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 l’expérience de paiement. Pour en savoir plus, consultez la documentation sur les options des moyens de paiement.