Sources et clientsObsolète

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 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. Cela est utile si c’est la première fois que vous voyez ce client.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  --data-urlencode email="paying.user@example.com" \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

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.

curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs/sources \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "source"="src_18eYalAHEMiOZZp1l9ZTjSU0"

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_source.

curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d default_source=src_18eYalAHEMiOZZp1l9ZTjSU0

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.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount="1099" \
  -d currency="eur" \
  -d customer=cus_AFGbOSiITuJVDs \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

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 avez besoin de détacher une source d’un objet Customer particulier, vous pouvez détacher la source. L’action change l’état de la source à 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 ne vous recommandons pas 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.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount="1099" \
  -d currency="eur" \
  -d customer=cus_AFGbOSiITuJVDs \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

L’objet Charge (paiement) 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 à l’autre.