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.

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.