Sources et clientsObsolète
Découvrez comment rattacher et gérer les sources avec les objets Customer.
Alerte
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.
While we don’t plan to remove support for card payments, we recommend replacing any use of the Sources API with the PaymentMethods API, which provides access to our latest features and payment method types.
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 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 associer une source réutilisable à un objet Customer avant d’effectuer une demande de paiement. Si vous débitez une source réutilisable sans l’associer d’abord, la source sera consommée (son état passera de chargeable à consumed. 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. Cela 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 retirer une source d’un objet Customer particulier, vous pouvez dissocier la source. Cette action change l’état de la source à consumed, de sorte qu’elle ne peut pas être utilisée une fois dissocié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 ne vous recommandons pas de les associer 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 aux objets Customer et Source, même s’ils ne sont pas directement liés l’un à l’autre.