Fuentes y clientesObsoleto
Más información sobre cómo agregar y administrar 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, como lo indica su parámetro usage. Mientras que algunas fuentes admiten cargos directamente, las fuentes reutilizables deben estar siempre asociadas a un objeto Customer para poder reutilizarse con posterioridad. Mediante la asociación de fuentes reutilizables al objeto Customer, puedes proporcionarles a tus clientes una lista de métodos de pago reutilizables que ya se emplearon con anterioridad con tu aplicación o en tu sitio web.
Fuentes reutilizables
Algunos métodos de pago (como el débito directo SEPA) admiten fuentes reutilizables, por lo que puedes crear otros pagos sin que tu cliente tenga que completar otra vez el proceso de pago. Una fuente que puede reutilizarse tiene el parámetro usage establecido en reusable.
Debes asociar una fuente reutilizable al objeto Customer antes de hacer la solicitud de cargo. Si efectúas un cargo en una fuente reutilizable sin haberla asociado al cliente antes, la fuente se consume (el estado pasa de chargeable a consumed), y no se podrá utilizar para pagos futuros.
Cómo asociar una fuente a un objeto Customer nuevo
Puedes crear el objeto Customer y asociarlo a una fuente en una llamada API. Esto es útil si es un cliente que opera por primera vez.
La fuente se convierte en la fuente predeterminada del objeto Customer, dado que es el primero y el único método de pago del cliente. Si haces la solicitud de un cargo utilizando el parámetro customer sin especificar source, se selecciona automáticamente la fuente predeterminada.
Cómo asociar una fuente a un objeto Customer existente
Si actualizas un objeto Customer que tiene una fuente predeterminada, la fuente existente se desasocia automáticamente y se agrega la fuente especificada como nueva fuente predeterminada. Para agregar una fuente sin reemplazar la fuente existente, utiliza el método de asociación que se muestra a continuación.
En este caso, debido a que el objeto Customer ya puede tener una fuente predeterminada, la fuente recién asociada no se toma como valor predeterminado. Sin embargo, puedes establecerla como fuente predeterminada actualizando el objeto Customer y especificando la fuente como valor de default_.
Cómo efectuar un cargo en una fuente asociada
Debes especificar el objeto Customer y la fuente al hacer la solicitud de pago.
Si intentas efectuar un cargo en un objeto Customer sin especificar la fuente, Stripe utiliza la fuente predeterminada del cliente.
Cómo desasociar una fuente
Si tienes que eliminar una fuente de un determinado objeto Customer, puedes desasociar la fuente. El estado de la fuente pasa a consumed y ya no se podrá utilizar una vez desasociada.
Fuentes de un solo uso
Las fuentes de un solo uso deben crearse cada vez que el cliente efectúa un pago y no pueden reutilizarse. Por este motivo, no es recomendable asociarlas a clientes en forma predeterminada.
Si quieres asociar un pago a un determinado objeto Customer, puedes incluir el parámetro customer al hacer la solicitud de pago con una fuente, aunque la fuente no esté asociada.
El objeto resultante Charge hace referencia a los objetos Customer y Source, incluso si no están directamente relacionados entre sí.