Fuentes y clientesObsoleto
Advertencia
La API Sources quedó obsoleta y planeamos hacer que deje de admitir los métodos de pago locales. Si actualmente manejas métodos de pago locales con la API Sources, debes migrarlos a la API Payment Methods. Te enviaremos una comunicación por correo electrónico con más información sobre este cambio.
Si bien no planeamos dejar de admitir pagos con tarjeta, recomendamos reemplazar los usos de la API Sources con la API PaymentMethods, que proporciona acceso a nuestras más recientes funcionalidades y tipos de métodos de pago.
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 ser reutilizadas 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 fueron empleados con anterioridad con tu aplicación o en tu sitio web.
Fuentes reutilizables
Certain payment methods (for example, SEPA Direct Debit) support reusable sources, so that you can create additional payments without your customer’s needing to complete the payment process again. A source that you can reuse has its usage
parameter set to reusable
.
Debes asociar una fuente reutilizable al objeto Customer
antes de hacer la solicitud de pago. Si efectúas un cargo en una fuente reutilizable sin haberla asociado al cliente, 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_source
.
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 necesitas 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 Charge
resultante hace referencia tanto al objeto Customer
como al objeto Source
, aunque no estén directamente relacionados entre sí.