Operación del Plugin 🅱️

Configura los métodos de pago que vas a aceptar en la tienda de tu comercio. Estos dependen de las condiciones comerciales que tu comercio tenga activo con Kushki.

Conoce cómo puedes utilizar el plugin de Kushki que instalaste y configuraste en tu tienda VTEX.

4. Operación del Plugin

4.1. Visualización del administrador

Al ser el administrador de tu tienda VTEX, podrás:

  • Visualizar un listado de las transacciones que has recibido, incluyendo el medio de pago que utilizan tus clientes. Recuerda que, desde tu tienda VTEX o el panel de Kushki, podrás obtener más información sobre tus transacciones.

Para validar el estado de las órdenes realizadas en tu comercio, realiza lo siguiente:

4.1.1. Ingresa a tu tienda de administración de VTEX.
4.1.2. En el panel lateral principal, selecciona el ícono de Pedidos 🛒.
4.1.3. Escoge Todos los pedidos.
4.1.4. Haz clic sobre la orden en la que requieres visualizar su estado y demás características.

  • Consultar el detalle del listado de pedidos: observarás si el pago fue realizado mediante Kushki y el ID de transacción correspondiente.
  • Visualizar los pagos realizados desde el dashboard de Kushki.

4.2. Visualización de la transacción en la consola de Kushki

Para verificar la información de las transacciones que has recibido en tu tienda de VTEX desde la Consola de Kushki, ten en cuenta que, encontrarás habilitados los siguientes ticket numbers con los que podrás conciliar la información de dichas transacciones:

  • NSU del pago: corresponde al número del ticket de la transacción.
  • ID de la transacción: corresponde al número de la referencia de la transacción (transaction_reference).

Para encontrar esta información, ingresa a tu tienda de VTEX > en el panel lateral principal, selecciona el ícono de Pedidos 🛒 y luego Transacciones > haz clic en la Transacción que requieres buscar > en la parte inferior izquierda de la pantalla encontrarás los campos NSU del pago y ID de la transacción.

En la consola de Kushki asignada a tu tienda, ingresa la información del número del NSU del pago en la sección de Transacciones.

PaymentNSUyPaymentTID

4.3. Estado de las órdenes en VTEX

Al realizar pagos en tu tienda de VTEX, las transacciones se clasifican en diferentes estados dependiendo de la etapa en la que se encuentran, desde el inicio del proceso de autorización hasta la finalización de la misma de manera exitosa.

Para conocer cuáles son los diferentes estados de las órdenes generadas en tu tienda, te recomendamos visitar la Guía de flujo de las transacciones en Pagos; disponible en el Centro de Ayuda de VTEX.

4.4. Actualización de los estados de las órdenes en la Consola de Kushki

Ten en cuenta que las notificaciones de los estados de las transacciones que recibas en tu comercio con los métodos de pago de efectivo, transferencia y tarjeta se realizarán mediante la configuración de Webhooks. Estos se encontrarán configurados en tu Consola de Kushki, una vez recibas tus cuentas de producción y UAT.

4.5. Tipos de documentos disponibles

Desde tu tienda VTEX podrás visualizar los tipos de documentos disponibles en el país en el que opera tu comercio y cómo lo recibirá tu integración con Kushki. Estos dependen del tipo de persona que se encuentre haciendo la transacción; son los siguientes:

Tipo de persona/PlataformaVTEXKushki
Persona naturalNo aplicaNo aplica
Persona jurídicaRFCRFC

4.6. Procesamiento de pagos

4.6.1. Procesa pagos con efectivo

Una vez el cliente de tu comercio va a realizar el checkout de la compra en su carrito, este debe completar un formulario con sus datos personales: Correo, Nombre, Apellidos, Documento de identificación, y Teléfono/ Móvil . Es requerido también que tu cliente incluya la Dirección de envío y que seleccione el pago en efectivo como su método de pago.

Al hacer clic en Comprar ahora, tu cliente verá en pantalla un mensaje de confirmación del procesamiento de su orden, así como el PDF de la orden de pago. Esta también será enviada a la dirección de correo electrónico proporcionada en el formulario. Con la orden de pago, el cliente podrá dirigirse a alguno de los puntos de pago indicados en el PDF.

En VTEX, una vez se genere una nueva orden con Kushki Cash, podremos ver la transacción en el listado de órdenes (Pedidos 🛒 > Transacciones) con el estado Iniciado, el cuál nos indica que el pago está en espera de ser realizado. Tu cliente verá esta transacción como Inicializada desde el checkout.

Una vez se haya realizado el pago de manera exitosa, el estado de la orden cambiará a Aprobado, indicando que la transacción ha sido correctamente pagada. Si el tiempo venció y no se realizó el pago, el estado de la orden aparecerá como Cancelado.

4.6.2. Procesa pagos con transferencia

Una vez el cliente de tu comercio va a realizar el checkout de la compra en su carrito, este debe completar un formulario con sus datos personales: Correo, Nombre, Apellidos, Documento de identificación, y Teléfono/ Móvil. Es requerido también que tu cliente incluya la Dirección de envío y que seleccione la opción de transferencia como su método de pago.

Al hacer clic en Comprar ahora, tu cliente será redirigido a una pantalla intermedia, en donde aparecerá la Cuenta Clabe y el Número de orden de la transacción para que tu cliente pueda continuar la transacción desde su Banca en Línea.

Al hacer el pago, podrá volver al comercio, en donde tu cliente verá una confirmación de su pedido. La información también será enviada a la dirección de correo electrónico proporcionada en el formulario.

En VTEX, una vez se genere una nueva orden con Kushki-Transfer, podrás ver la transacción en el listado de órdenes (Pedidos 🛒 > Transacciones) y como administrador de tu tienda, podrás ver el estado de la orden como Iniciado; esperando una aprobación de pago. Una vez la transferencia sea aprobada, la transacción se mostrará como Aprobada.

4.6.3. Procesa pagos con tarjeta

4.6.3.1. Proceso de compra del cliente

Una vez el cliente de tu comercio va a realizar el checkout de la compra en su carrito, este debe completar un formulario con sus datos personales: Correo, Nombre, Apellidos, Documento de identificación, y Teléfono/ Móvil. Es requerido también que tu cliente incluya la Dirección de envío y que seleccione el pago con tarjeta como su método de pago.

Al seleccionar como método de pago Tarjeta de crédito o Tarjeta de débito, tu cliente deberá:

4.6.3.1.1. Ingresar el Número de su tarjeta y validar que SI, EL NÚMERO DE LA TARJETA ES CORRECTO.

4.6.3.1.2. Seleccionar la Franquicia a la que pertenece la tarjeta de crédito o débito.

4.6.3.1.3. Ingresar el Nombre y Apellido como figura en la tarjeta.
4.6.3.1.4. Añadir el Mes y Año de la Fecha de vencimiento de la tarjeta.
4.6.3.1.5. Escribir el Código de seguridad.
4.6.3.1.6. Hacer clic en la casilla de validación para confirmar la Dirección de envío del pedido solicitado.
4.6.3.1.7. Seleccionar el botón Comprar ahora.

En VTEX, una vez se genere una nueva orden con KushkiCards, podrás ver la transacción en el listado de órdenes (Pedidos 🛒 > Transacciones) con el estado Iniciado, el cuál nos indica que el pago está en espera de ser realizado. Tu cliente verá esta transacción como Inicializada desde el checkout.

Una vez se haya realizado el pago de manera exitosa, el estado de la orden cambiará a Aprobado, indicando que la transacción ha sido correctamente pagada. Cuando el pedido sea facturado, la transacción se actualizará a Finalizada.

Si el tiempo venció y no se realizó el pago, el estado de la orden aparecerá como Cancelada.

4.6.3.2. Pagos con autorización y captura

Al momento de configurar el método de pago de tarjeta por medio del conector de KushkiCards, podrás habilitar la opción de pago en dos pasos.

Para hacerlo, por favor ingresa a tu tienda VTEX > selecciona el ícono de Configuración de la tienda ⚙️ que se encuentra en la parte inferior izquierda de la pantalla > En PAGO, selecciona Configuración > Haz clic en KushkiCards > En el campo Autorización y captura diferidos, selecciona Si > Presiona el botón Guardar.

Proceso de autorización y captura

Cuando el cliente de tu comercio realice la compra, esta orden aparecerá en Pedidos 🛒 > Transacciones como Aprobada; lo que significa que esta orden se encuentra pre autorizada en el sistema.

Para capturar el pago, realiza lo siguiente:

4.6.3.2.1. Ingresa a Pedidos 🛒 y luego a Transacciones.
4.6.3.2.2. Selecciona la transacción que requieres autorizar.
4.6.3.2.3. Haz clic en el ícono de la Orden que aparece en la parte superior derecha de la pantalla.
4.6.3.2.4. Selecciona Iniciar preparación.
4.6.3.2.5. Haz click en las casillas de validación, confirmando que Entiendes que este proceso interferirá con el avance del pedido, que esta Acción no puedes deshacerla y que Conoces las consecuencias de esta acción en el flujo del pedido.
4.6.3.2.6. Haz clic en Proceder con el status.
4.6.3.2.7. Luego de actualizar la orden hasta el flujo final, haz clic en Factura.
4.6.3.2.8. Selecciona el Método de facturación.
4.6.3.2.9. Completa los datos de los Detalles de facturación.
4.6.3.2.10. Haz clic en Guardar factura.

El siguiente GIF te mostrará el proceso del paso a paso anteriormente mencionado:

Paso a paso proceso de autorización y captura

Proceso de autorización y captura

Al hacer este proceso, iniciará el proceso de captura y de facturación y el estado de la orden cambiará a Finalizado en Pedidos 🛒 > Transacciones y en Pedidos 🛒> Todos los pedidos aparecerá como Facturado.

Estado finalizado autorización y captura

Estado facturado autorización y captura

4.6.3.3. Pagos diferidos

Al momento de configurar el método de pago de tarjeta por medio del conector de KushkiCards, podrás habilitar la opción de pagos diferidos.

Para hacerlo, realiza los siguientes pasos:

4.6.3.3.1. Ingresa a tu tienda VTEX.
4.6.3.3.2. Selecciona el ícono de Configuración de la tienda ⚙️ que se encuentra en la parte inferior izquierda de la pantalla.
4.6.3.3.3. En PAGO, selecciona Configuración.
4.6.3.3.4. Escoge Condiciones de pago.
4.6.3.3.5. Haz clic en la Franquicia en la que quieres habilitar los pagos diferidos.
4.6.3.3.6. Selecciona la opción Cuotas.
4.6.3.3.7. Completa la información que aparece en pantalla, incluyendo el Número de cuotas, el valor de la Cuota mínima, el Método de facturación y la opción para activar el cobro de Intereses externos.
4.6.3.3.8. Presiona el botón Guardar.

Pagos diferidos

Al momento de que tu cliente:

  • Realice el pago con un monto mayor al que incluiste para activar el pago diferido,
  • Seleccione la franquicia de tarjeta que configuraste;

Este podrá seleccionar el número de cuotas con las que realizará el pago total.

Selección de número de cuotas pagos diferidos

4.6.3.4. Pagos únicos con tarjeta con OTP

Si te encuentras interesado en agregar una capa adicional de seguridad para las transacciones que recibas en tu comercio, puedes hacerlo a través del proceso de autenticación de OTP.

Una vez tu cliente complete la información del pago y haga clic en el botón Comprar ahora, Kushki revisará si la autenticación de OTP debe activarse. De ser así, el sistema mostrará una pantalla similar a la que se presenta a continuación en la que le mencionará que el sistema realizará un pequeño cobro de un monto aleatorio, el cual contiene 3 dígitos. Este será enviado a la tarjeta que el cliente digitó para completar la transacción. Luego de verificar la transacción, esta será reversada inmediatamente.

Autenticación OTP

Tu cliente tendrá hasta 3 oportunidades para ingresar las 3 cifras que ha recibido de manera correcta; de lo contrario, la transacción que se encuentra realizando aparecerá como Cancelada.

4.6.3.5. Pagos únicos con tarjeta con 3DS

Con el fin de garantizar seguridad a tus clientes, nuestro plugin te ofrece la opción de implementar el proceso de autenticación 3DS.

Una vez tu cliente complete la información del pago y haga clic en el botón Comprar ahora, Kushki revisará si la autenticación de 3DS debe activarse. De ser así, una pantalla similar a la presentada a continuación aparecerá en el flujo del pago en la que deberá ingresar el código que ha recibido en su teléfono celular para continuar con la transacción.

Este tendrá hasta 3 oportunidades para ingresar el código que ha recibido; de lo contrario, la transacción que se encuentra realizando aparecerá como Cancelada.

Tu cliente podrá ver una pantalla similar a la siguiente:

Autenticación 3DS

4.6.3.6. Cancelaciones y reembolsos

4.6.3.6.1. Cancelaciones

Si deseas cancelar un pago que aún no ha sido facturado, puedes realizar una cancelación de la transacción.

Para hacerlo, por favor realiza los pasos a continuación:

4.6.3.6.1.1. Ingresa a tu tienda VTEX.
4.6.3.6.1.2. Selecciona el ícono de Pedidos 🛒 y luego escoge Todos los pedidos.
4.6.3.6.1.3. Selecciona la orden que requieres cancelar, la cual debe encontrarse en cualquiera de los estados disponibles, a excepción de Facturado.
4.6.3.6.1.4. En la parte superior derecha de la pantalla, haz clic en Cancelar pedido.
4.6.3.6.1.5. Presiona cada una de las Casillas de validación; ten en cuenta que este proceso no se puede deshacer e interfiere con el avance del pedido.
4.6.3.6.1.6. Ingresa el Motivo de la cancelación.
4.6.3.6.1.7. Selecciona Confirmar. ¡Listo! El estado de la orden aparecerá como Cancelada una vez VTEX confirme con el medio de pago la solicitud de anulación.

4.6.3.6.2. Reembolsos totales en moneda local para pagos con tarjeta

Si deseas devolver un pago que ya fue recibido o capturado, puedes solicitar un reembolso de la transacción realizada por tu cliente.

Para solicitar el reembolso total de los pagos que has recibido a través de tarjeta en tu comercio, realiza los pasos que se encuentran a continuación:

4.6.3.6.2.1. Inicia sesión en la plataforma VTEX.
4.6.3.6.2.2. En Pedidos 🛒 , selecciona Todos los pedidos.
4.6.3.6.2.3. Busca la orden en la que requieres hacer el reembolso.

4.6.3.6.2.4. En Factura, haz clic en Devolver items.
4.6.3.6.2.5. Selecciona todos los Productos a reembolsar (reembolso total), indicando las Unidades o demás características de los artículos devueltos.
4.6.3.6.2.6. En Detalle de la devolución, escribe el Número de la factura en la que se hará el proceso de reembolso.
4.6.3.6.2.7. Haz clic en Solicitar reembolso.

¡Listo! El sistema procesará tu solicitud. Una vez que el sistema la apruebe, este mostrará un mensaje en el historial de la transacción, especificando que dicha transacción ha sido reembolsada totalmente.

5. Recomendaciones adicionales

Ten en cuenta las siguientes sugerencias:

  • Si tu tienda de VTEX presenta problemas de rendimiento, por favor revisa la página de actualizaciones de incidentes de VTEX, la cual incluye el reporte diario de los errores reportados en esta plataforma.

  • Asegúrate que las credenciales que has configurado son las correctas, ya que, al utilizar claves incorrectas, puede ocurrir que en tu tienda no aparezca el medio de pago. Adicional a este chequeo, te recomendamos realizar el paso a paso mencionado en este manual. En caso de que el problema persista para este escenario, por favor contacta a Soporte.

  • Si requieres revisar información sobre el registro de afiliaciones de gateway, revisa la sección de Tutoriales y Soluciones, la cual está disponible en la plataforma de VTEX.

  • Si necesitas obtener más información para configurar las condiciones de pago de tu tienda, ingresa a la sección Tutoriales y Soluciones de la plataforma VTEX.

  • Visita las siguientes guías del Centro de Ayuda de VTEX para conocer las políticas comerciales con las que puedes establecer reglas de configuración, tales como: