Fuentes y clientesObsoleto
Descubre cómo vincular y gestionar las fuentes con objetos Customer.
Advertencia
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 objeto Source puede ser de un solo uso o reutilizable, según lo que figure en el parámetro usage. Mientras que las fuentes pueden cobrarse directamente, las fuentes reutilizables siempre deben estar vinculadas a un objeto Customer para su uso posterior. Al vincular fuentes reutilizables a objetos Customer, puedes presentar a tus clientes una lista de los métodos de pago reutilizables que han empleado anteriormente en tu aplicación o sitio web.
Fuentes reutilizables
Algunos métodos de pago (por ejemplo, el adeudo directo SEPA) admiten fuentes reutilizables, por lo que puedes crear pagos adicionales sin que tu cliente tenga que volver a completar el proceso de pago. Las fuentes que puedes reutilizar tienen el parámetro usage establecido como reusable.
Debes vincular una fuente reutilizable a un objeto Customer antes de hacer una solicitud de cobro. Si haces un cargo en una fuente reutilizable sin vincularla antes, se consume la fuente (su estado pasa de chargeable a consumed). Las fuentes consumidas no pueden utilizarse para otros pagos.
Cómo vincular una fuente a un nuevo objeto Customer
Puedes crear un objeto Customer y vincular una fuente en una llamada a la API. Esto resulta útil si es la primera vez que tratas con este cliente.
La fuente pasa a ser la fuente predeterminada del objeto Customer, ya que este es el primer y único método de pago del cliente. La fuente predeterminada se selecciona automáticamente si haces una solicitud de cargo utilizando el parámetro customer sin especificar una source.
Cómo vincular una Source a un objeto Customer existente
Al actualizar un objeto Customer con una fuente predeterminada, la fuente existente se separa y se añade la fuente proporcionada como nueva fuente predeterminada. Para añadir una fuente sin sustituir la existente, utiliza el método de vincular que aparece a continuación.
En este caso, como es posible que ya exista una fuente predeterminada para el objeto Customer, la fuente recién vinculada no pasa a ser la fuente predeterminada. No obstante, puedes cambiar la fuente predeterminada actualizando el objeto Customery especificando la fuente como valor de default_.
Cómo cambiar una fuente vinculada
Al hacer una solicitud de cambio, debes especificar tanto el objeto Customer como la fuente.
Si intentas cobrar un objeto Customer sin especificar una fuente, Stripe utiliza la fuente predeterminada del cliente.
Separar una fuente
Si quieres eliminar una fuente de un objeto Customer en particular, puedes separar la fuente. Al hacerlo, el estado de la fuente cambia a consumed, por lo que no puede usarse una vez que se ha separado.
Fuentes de un solo uso
Las fuentes de un solo uso deben crearse cada vez que un cliente realiza un pago, y no se pueden reutilizar. Por ese motivo, no te recomendamos que las vincules de forma permanente a los clientes.
Si quieres asociar un pago con un objeto Customer en particular, puedes incluir un parámetro customer al efectuar una solicitud de cobro con una fuente, incluso aunque la fuente no esté vinculada.
El objeto resultante Charge hace referencia a los objetos Customer y Source, incluso si no están directamente relacionados entre sí.