La API SourcesObsoleto

Source objects allow you to accept a variety of payment methods with a single API. A source represents a customer’s payment method, and you can use it with the Stripe API to create payments. You can charge sources directly, or attach them to customers for later reuse.

Cada método de pago aceptado por la API Sources es definido por cuatro características clave. La combinación de estas características determina cómo se imputan los cargos en la fuente y cómo se usa la solicitud de pago para completar un pago.

• Extraer o enviar: cómo se transfieren los fondos del método de pago del cliente
• Flujo: el tipo de acción que debe llevar a cabo tu cliente para autenticar el pago
• Uso: determina si la Source se puede reutilizar o no
• Sincrónico o asincrónico: determina si el cargo resultante puede confirmarse de inmediato o después de un retraso

Para ver un ejemplo acabado que ilustre cómo aceptar cualquier método de pago con la API Sources, echa una ojeada a este modelo de tienda de e-commerce y explora el código fuente en GitHub.

Métodos de pago aceptados

You can enable any payment method available to you within the Dashboard. Activation is generally instantaneous, and doesn’t require additional contracts nor include a lengthy process. For a detailed listing, see the available payment methods and their supported geographical regions.

La siguiente tabla muestra las características clave antes mencionadas de los métodos de pago aceptados:

Extracción o envío de fondos

Cada método de pago se clasifica como de extracción o envío según cómo se transfieran los fondos del método de pago del cliente.

• Using a pull method, you debit the funds from the customer’s account after the customer has provided consent. Card payments are an example of a pull method: your customer’s card is debited when a payment is made, and no customer interaction is required for subsequent debits.
• Con un método basado en el envío, el cliente te envía los fondos. Las transferencias de crédito ACH son un ejemplo de un método basado en el envío: tu cliente recibe los números de enrutamiento bancario y de cuenta a los que debe enviar (basado en el envío) el importe correcto. Una vez que tengas la confirmación de que tu cliente te envió los fondos, se puede imputar el cargo a la fuente y estará lista para usarse en una solicitud de pago. Otros métodos de pago basados en el envío, como iDEAL o Sofort, requieren un redireccionamiento para que tu cliente te envíe el dinero directamente desde su cuenta bancaria electrónica. Por lo general, los métodos basados en el envío requieren una interacción con el cliente para cada pago.

Flujo de acción del cliente

Algunos métodos de pago requieren que el cliente lleve a cabo una acción en particular (flujo) para poder imputar el cargo en la fuente. El tipo de flujo que se aplicará a un método de pago se determina dentro del parámetro flow del objeto Source. Cada método se clasifica conforme a uno de los siguientes tipos de flujo.

Sin acción del cliente

Flujo de redireccionamiento

Flujo de verificación del código

Flujo de destinatario

No se requiere acción del cliente. Algunos métodos de pago (en general, métodos de extracción), como las tarjetas (salvo 3D Secure), solo exigen la recopilación de los datos del pago del cliente a modo de autenticación. Los objetos Source que representan este método de pago pueden utilizarse de inmediato en cuanto se hace una solicitud de pago.

Una vez que se ha completado el flujo solicitado y la fuente está en condiciones de aceptar cargos, debe utilizarse la fuente para solicitar el cargo a fin de que el pago se complete. De lo contrario, la fuente se cancela, se rembolsa automáticamente el pago autenticado del cliente, y no se transfiere el dinero a tu cuenta.

De un solo uso o reutilizables

Algunos métodos de pago admiten la creación de fuentes que se puedan reutilizar para otros pagos sin que tu cliente tenga que completar nuevamente el proceso de pago. Las fuentes que se pueden reutilizar tienen el parámetro usage establecido en reusable.

En cambio, si una fuente solo se puede usar una vez, este parámetro se establece en single_use, y debe crearse una fuente cada vez que el cliente hace un pago. Estas fuentes no deben adjuntarse a clientes, ya que el cargo debe imputarse en forma directa. Se puede cobrar solo una vez, y el estado de la fuente cambia a consumed después del cobro.

Reusable sources must be attached to a Customer to be reused. (If charged directly, their status will change to consumed.)

Confirmación sincrónica y asincrónica

Una vez que usas un método de pago para crear un objeto Charge, el estado de ese cargo se puede confirmar de inmediato (de manera sincrónica) o después de un período (de manera asincrónica).

• Con un método de pago sincrónico, el estado de la solicitud de pago se puede confirmar de inmediato como succeeded o failed. Si la solicitud de pago se efectúa correctamente, el pago se completa, pues se considera garantizado que se le ha cobrado al cliente y que tú recibirás los fondos. Un ejemplo de método sincrónico son los pagos con tarjeta: se confirma en tiempo real si el pago se efectuó correctamente o no.

• En caso de métodos de pago asincrónicos, la confirmación del pago puede demorar varios días. Durante este tiempo, no se puede garantizar el pago. El estado del objeto Charge del pago se define inicialmente en pending, hasta que se confirma si el pago se efectuó correctamente o no. Los débitos ACH son un ejemplo de método asincrónico: con estos débitos, la confirmación del pago tarda algunos días.

Stripe envía un evento webhook una vez que el estado del cargo ha cambiado. Al aceptar un método de pago asincrónico, tu integración debe ser capaz de recibir webhooks para poder aceptar la notificación y confirmar si el pago del cliente se hizo correctamente o no.