La API SourcesObsoleto

Los objetos Source te permiten aceptar varios métodos de pago con una misma API. La fuente representa el medio de pago de un cliente y puede utilizarse con la API de Stripe para crear pagos. Las fuentes pueden cargarse directamente, o asociarse a los clientes para su posterior reutilización.

Cada método de pago admitido por la API Sources está definido por cuatro características clave. La combinación de estas características determina cómo se convierte una fuente en cobrable, y cómo se utiliza en una petición del cargo para completar un pago.

• Pull o push: cómo se transfieren los fondos para el método de pago de tu cliente
• Flujo: el tipo de acción que debe llevar a cabo tu cliente para autenticar el pago
• Uso: si el Source es reutilizable o no
• Síncrono o asíncrono: si el pago resultante puede confirmarse inmediatamente o solo tras un breve espacio de tiempo

Para ver un ejemplo completo que ilustre cómo aceptar cualquier método de pago que utilice la API Sources, consulta esta tienda de comercio electrónico de ejemplo y explora su código fuente en GitHub.

Métodos de pago aceptados

Puedes habilitar cualquier método de pago disponible en el Dashboard. La activación suele ser instantánea y no requiere contratos adicionales ni conlleva un proceso extenso. Para obtener una lista detallada, consulta los métodos de pago disponibles y sus regiones geográficas aceptadas.

La siguiente tabla relaciona las características mencionadas anteriormente con los métodos de pago admitidos:

Pull o push de fondos

Cada método de pago se clasifica como pull o push, según la forma de envío de fondos desde el método de pago del cliente.

• Al usar un método pull, adeudas los fondos de la cuenta del cliente una vez que el cliente ha dado su consentimiento. Los pagos con tarjeta son un ejemplo de método pull: se efectúa el adeudo en la tarjeta de tu cliente cuando se efectúa un pago, y no se requiere la interacción del cliente para los adeudos posteriores.
• El cliente te envía los fondos usando un push method. Las transferencias de crédito ACH son un ejemplo de un método push: se le proporciona a tu cliente los números de la ruta y de la cuenta bancaria a los que debe enviar (push) el importe correcto. Después de la confirmación de que tu cliente te ha enviado los fondos, la fuente pasa a ser cobrable y estará lista para utilizarse en una solicitud de pago. Otros métodos de pago push, como iDEAL o Sofort, dependen de una redirección para que tu cliente te envíe el dinero directamente desde su cuenta bancaria en línea. Por lo general, los métodos push requieren una interacción con el cliente para cada pago.

Flujo para la acción del cliente

Algunos métodos de pago requieren que tu cliente complete una acción determinada (flujo) antes de que la fuente pueda cobrarse. El tipo de flujo que se aplica a un método de pago se indica en el parámetro flow del objeto Source. Cada método se clasifica en uno de los siguientes tipos de flujo.

Sin acción del cliente

Flujo de redireccionamiento

Flujo de verificación del código

Flujo del destinatario

No es necesaria ninguna acción por parte de tu cliente. Algunos métodos de pago (por lo general, los métodos pull), como las tarjetas (sin incluir 3D Secure), no requieren autenticación adicional más allá de la obtención de la información de pago de los clientes. Las fuentes que representan este método de pago pueden usarse inmediatamente al hacer peticiones de cargo.

Una vez que se ha completado el flujo requerido y la fuente pasa a ser cobrable, debe utilizarse la fuente para hacer una petición de cargo para que se complete el pago. En caso contrario, la fuente se cancela y el pago autenticado del cliente se reembolsa automáticamente; no se transfiere dinero a tu cuenta.

De un solo uso o reutilizable

Algunos métodos de pago permiten la creación de fuentes que pueden reutilizarse para pagos adicionales sin que tu cliente tenga que volver a completar el proceso de pago. Las fuentes que pueden reutilizarse tienen el parámetro usage establecido como reusable.

Por el contrario, si una fuente solo puede utilizarse una vez, este parámetro se establece como single_use, y debe crearse una fuente cada vez que un cliente efectúe un pago. Estas fuentes no deben asociarse a los clientes, sino que deben cobrarse directamente. Solo pueden cobrarse una vez, y su estado cambiará a consumed cuando se efectúe el cobro.

Las fuentes reutilizables deben asociarse a un Customer para poder reutilizarlas. (Si se cobra directamente, su estado cambiará a consumed.) Para saber cómo asociar Sources a Customers, y para gestionar la lista de fuentes de un Customer, consulta la guía Sources y Customers.

Confirmación síncrona o asíncrona

Una vez que usas un método de pago para crear un objeto Cargo, el estatus de ese cargo puede confirmarse o bien inmediatamente (de forma sincrónica) o bien al cabo de cierto tiempo (de forma asincrónica).

• Con un método de pago síncrono, el estado de la petición del cargo puede confirmarse inmediatamente como succeeded o failed. Si la petición del cargo es satisfactoria, se completa el pago; se entiende que está garantizado que el cliente ha recibido el cargo y que vas a recibir los fondos. Los pagos con tarjeta son un ejemplo de método de pago síncrono: hay confirmación en tiempo real de la ejecución o no del pago.

• En el caso de los métodos de pago asíncronos, la confirmación de que el pago se ha efectuado correctamente puede tardar varios días. Durante este período, no se puede garantizar el pago. El estado del objeto Charge del pago se establece inicialmente como pending, hasta que se confirme que el pago se ha efectuado correctamente o no. Los adeudos ACH son un ejemplo de método asíncrono: con estos adeudos, se tarda unos días en confirmar que el pago ha sido satisfactorio.

Stripe envía un evento del webhook una vez que ha cambiado el estado de un cargo. Al aceptar cualquier método de pago que sea asíncrono, tu integración debe poder recibir webhooks, para que pueda recibir esta notificación y confirmar si el pago del cliente se ha efectuado correctamente o si ha fallado.