Sources et clientsObsolète
Découvrez comment rattacher et gérer les sources avec les objets Customer.
Avertissement
We deprecated the Sources API and plan to remove support for local payment methods. If you currently handle any local payment methods using the Sources API, you must migrate them to the Payment Methods API.
Nous ne prévoyons pas de supprimer la prise en charge des paiements par carte, mais nous vous recommandons tout de même de remplacer l’API Sources par l’API PaymentMethods, qui donne accès à nos dernières fonctionnalités et types de moyens de paiement.
Un objet Source peut être à usage unique ou réutilisable, comme indiqué par son paramètre usage. Bien que les sources puissent être débitées directement, les sources réutilisables doivent toujours être rattachées à un objet Customer pour une réutilisation ultérieure. Le rattachement de sources réutilisables à des objets Customer vous permet de présenter à vos clients une liste de moyens de paiement réutilisables qu’ils ont précédemment utilisés avec votre application ou site Web.
Sources réutilisables
Certains moyens de paiement (par exemple, le prélèvement automatique SEPA) prennent en charge les sources réutilisables, de sorte que vous pouvez créer des paiements supplémentaires sans que votre client n’ait à se plier à nouveau au processus de paiement. Le paramètre usage d’une source réutilisable est réglé sur reusable.
Vous devez rattacher une source réutilisable à un objet Customer avant de faire une demande de paiement. Si vous facturez une source réutilisable sans la rattacher au préalable, la source est consommée (son état passe de chargeable (facturable) à consumed (consommé). Les sources consommées ne peuvent pas être utilisées pour des paiements ultérieurs.
Rattacher une source à un nouvel objet Customer
Vous pouvez créer un objet Customer et lui rattacher une source en un seul appel d’API. Ceci est utile si c’est la première fois que vous voyez ce client.
La source devient la source par défaut de l’objet Customer puisqu’il s’agit du premier et seul moyen de paiement du client. La source par défaut est automatiquement sélectionnée si vous effectuez une demande de paiement avec le paramètre customer sans préciser une source.
Rattacher une source à un objet Customer existant
Lorsque vous mettez à jour un objet Customer, doté d’une source par défaut, la mise à jour détache automatiquement la source existante, et ajoute la source fournie comme nouvelle source par défaut. Pour ajouter une source sans remplacer la source par défaut existante, utilisez la méthode attach, comme indiqué ci-dessous.
Dans ce cas, comme une source par défaut peut déjà exister pour l’objet Customer, la nouvelle source rattachée ne devient pas la source par défaut. Cependant, vous pouvez changer la source par défaut en mettant à jour l’objet Customer et en précisant la nouvelle source comme étant la valeur par défaut du paramètre default_.
Débiter une source rattachée
Vous devez préciser à la fois l’objet Customer et la source lorsque vous effectuez une demande de paiement.
Si vous tentez de débiter un objet Customer sans en préciser la source, Stripe utilise la source par défaut du client.
Détacher une source
Si vous devez détacher une source d’un objet Customer particulier, vous pouvez détacher la source. L’action modifie l’état de la source, qui passe à consumed (consommé), si bien qu’une fois détachée, la source ne peut plus être utilisée.
Sources à usage unique
Les sources à usage unique doivent être créées chaque fois qu’un client effectue un paiement et elles ne peuvent plus être réutilisées. Pour cette raison, nous vous déconseillons de les rattacher de manière permanente aux clients.
Si vous voulez associer un paiement à un objet Customer particulier, vous pouvez inclure un paramètre customer lorsque vous effectuez une demande de paiement avec une source, même si celle-ci n’est pas rattachée.
L’objet Charge qui en résulte fait référence à la fois aux objets Customer et Source, même s’ils ne sont pas directement liés l’un avec l’autre.