¿Cómo funcionan los pagos con transferencias bancarias?#
Te explicamos cómo funciona un pago con transferencia en KushkiSi tus usuarios no poseen una tarjeta de crédito o desean aprovechar el saldo disponible en sus cuentas bancarias para efectuar una compra en línea, el débito a cuentas (transferencia bancaria) es la opción de pago ideal y rápida.Proceso de pago#
El proceso de pago con transferencias consiste en permitir a tu cliente utilizar el saldo disponible en su cuenta bancaria, para realizar el pago de una compra en tu sitio o app. Para ello, debes redireccionar a tu cliente al sitio de la entidad bancaria que seleccione en el checkout, con el fin de que autorice el débito del monto de la transacción de su cuenta.En Ecuador puedes ofrecer transferencias a través de dos procesadores: transferencia bancaria tradicional y DeUna!, la billetera digital respaldada por Banco Pichincha. El flujo de integración es el mismo en ambos casos; lo único que cambia es la forma en que tu cliente completa el pago.1. Selección del medio de pagoDentro de tu app o sitio web, el usuario debe seleccionar transferencia como medio de pago y diligencia los datos del formulario de pago.Tu comercio manda la solicitud de transferencia a Kushki para que inicie la transacción.Kushki te confirma la creación de la transacción y te retorna la URL a la que debes redireccionar al usuario.4. Redirección para selección del bancoTu comercio redirige al usuario a la URL indicada, para que seleccione su entidad bancaria y realice la transferencia.5. Ingreso al portal del banco y AutorizaciónCuando el usuario ingresa al sitio de su entidad bancaria, se autentica, verifica los datos de la transacción (descripción de la operación, monto y cuenta a debitar) y acepta que el monto de la operación, sea debitado del saldo de su cuenta.6. Confirmación del débitoCuando el usuario autoriza la transferencia, la entidad bancaria confirma a Kushki el resultado de la operación.7. Notificación de KushkiKushki te notifica el estado final de la transacción.Variante: pago con DeUna!#
DeUna! es la billetera digital con mayor penetración en Ecuador. Tu cliente paga con el saldo de su cuenta DeUna! desde la app, sin registrar una tarjeta ni seleccionar una entidad bancaria.DeUna! se habilita como procesador para tu comercio desde la Consola Kushki, y lo realiza el equipo de Kushki. Una vez habilitado, el mismo endpoint de inicio de transacción empieza a retornar los campos de DeUna!.
Las tres experiencias de pago#
Una sola solicitud te retorna las tres experiencias. Tú decides cuál mostrar según el canal por el que esté comprando tu cliente.| Experiencia | Campo en la respuesta | Ideal para | Apps compatibles |
|---|
| QR dinámico | qr | Checkout de escritorio: el cliente escanea con su celular | DeUna!, Banco Pichincha, Diners |
| Enlace de redirección | redirectUrl | Web móvil o tu propia app: abre DeUna! en un toque | DeUna! |
| Código de referencia | referenceCode | Alternativa cuando falla la cámara o el cliente prefiere digitar | DeUna!, Banco Pichincha |
Flujo de pago con DeUna!#
Los pasos 1, 2, 3, 6 y 7 son idénticos a los de la transferencia tradicional. Cambian el 4 y el 5.4. Presentación de la experiencia de pagoEn lugar de redireccionar al usuario a un portal bancario, tu comercio muestra la experiencia que corresponda a su canal: renderiza el qr en tu checkout, presenta el redirectUrl como botón de pago, o despliega el referenceCode para que lo digite en la app.Con QR y con código de referencia el usuario no sale de tu sitio.5. Confirmación en la app DeUna!El usuario abre DeUna!, verifica los datos de la transacción (comercio, número de pedido y monto) y confirma el pago con su biometría o PIN. El monto se debita de inmediato del saldo de su cuenta.Renderiza el código QR#
El campo qr contiene una imagen PNG codificada en Base64, con el prefijo data:image/png;base64, ya incluido. Debes leer el valor y renderizarlo como imagen en tu checkout: Kushki no aloja la imagen del QR por ti.Como qr ya trae el prefijo data:image/png;base64,, concatenarlo de nuevo genera un data URI inválido y la imagen falla de forma silenciosa: verás un espacio en blanco sin ningún error en consola.
Tiempos de expiración#
El QR, el enlace de redirección y el código de referencia expiran en 3 minutos, mientras que el token de la transacción dura 30 minutos. Genera la experiencia de pago en el momento en que tu cliente esté listo para pagar, muestra un contador en pantalla y solicita un token nuevo si expira.
Bancos soportados
Conoce los bancos y detalles de operación para transferencias bancarias
Explora esta sección#
