Guía de integración de Smart Checkou

#Introducción

Integre Viva.com Smart Checkout para permitir que los clientes realicen pagos seguros a través de una página de pago alojada. Esta guía lo guía a través de los pasos para una integración perfecta en su sitio web o aplicación.

---

#➤ Obtenga su cuenta Viva.com, si aún no tiene una

Viva.com admite dos entornos diferentes, asegúrese de usar el correcto:

#➤ Obtén tu fuente de pago en línea y conserva tu código fuente

Una fuente de pago es una entidad de configuración que permite a los comerciantes configurar y administrar la configuración de integración de pagos para sus sitios web o aplicaciones móviles.

Configura tu dominio y las URL a las que Viva.com Smart Checkout redirigirá a los clientes una vez finalizado el pago. Estas URL generalmente conducen a páginas como "Gracias por su pedido" para pagos exitosos o "Algo salió mal con su pago" para transacciones fallidas, lo que permite a los clientes continuar su viaje sin problemas en su sitio web o aplicación.

Cree una fuente de pago para los pagos en línea navegando a Ventas > Pagos online > Páginas web / aplicaciones en el panel de control de Viva.com.

Asegúrese de guardar el código fuente de 4 dígitos de la fuente de pago que acaba de crear, ya que lo necesitará más adelante para fines de integración y configuración.

Consulte aquí para obtener una guía detallada sobre cómo crear una Fuente para pagos en línea

#➤ Guía de integración paso a paso

Pasos clave para integrar

1. Crear la orden de pago

2. Redirigir a Smart Checkout

3. Gestionar la devolución del cliente y verificar el resultado del pago

➥ Paso 1: Crear la orden de pago

Para solicitar un pago a uno de sus clientes, debe crear una orden de pago. A cada orden de pago se le asigna un ID único de 16 dígitos, también conocido como orderCode.

Puedes generar la orden de pago mediante la API Crear orden de pago en tu servidor y pasar el orderCode a tu sitio web o aplicación.

Para obtener más detalles sobre cómo configurar una orden de pago, consulte nuestra guía detallada en nuestro portal para desarrolladores aquí y aquí.

➥ Paso 2: Redirigir al cliente al pago inteligente

Cuando se les redirija, los clientes verán el formulario de pago inteligente para ingresar sus detalles de pago y completar la transacción.

#➤ Opciones adicionales para Smart Checkout

• Opciones de fuente de pago

• Muestra el logotipo de tu marca

Puedes incluir el logotipo de tu marca para que se muestre en Smart Checkout configurándolo en la configuración de la fuente de pago. Hay una guía detallada en nuestro portal para desarrolladores aquí.

Agregar su logotipo mejora la experiencia del cliente al reforzar su identidad de marca durante el proceso de pago. Asegúrese de cargar un logotipo claro y del tamaño adecuado para una visualización óptima.

#➤ Mostrar un botón de cancelación

Proporcionar un botón Cancelar ofrece flexibilidad a sus clientes y ayuda a mejorar la experiencia general del usuario.

Puede configurar un botón Cancelar en Smart Checkout para brindar a los clientes la opción de cancelar sus pedidos. Esto se gestiona a nivel de fuente de pago (en Configuración avanzada), lo que le permite controlar si el botón Cancelar está disponible para los pedidos asociados a una fuente específica.

Plataformas compatibles: El botón Cancelar es actualmente compatible con integraciones directas de Smart Checkout y complementos para Shopify y PrestaShop.

Compatibilidad con webhooks: puede configurar webhooks para recibir notificaciones de eventos de cancelación de pedidos. Siga esta guía de configuración de webhook para obtener más información

➥ Paso 3: Manejar la devolución del cliente y verificar el resultado del pago

Gestionar la devolución del cliente

Después del pago, los clientes son redirigidos a:

• URL de éxito para pagos exitosos.

• URL de error para pagos fallidos.

Puede configurar estos ajustes a través del Panel de control de su cuenta Viva.com en Ventas > Pagos online > Páginas web / aplicaciones

Verificar el resultado del pago

La verificación garantiza que la transacción se complete correctamente. Para validar el estado de una transacción en el sistema, verifique los siguientes parámetros: Amount, transactionId, statusId (Ver todos los códigos de StatusId)

#➤ Métodos de verificación de pagos recomendados:

1. Webhooks:

   • Reciba actualizaciones en tiempo real sobre el éxito o el fracaso del pago.

   • Consulte nuestra documentación de webhooks Transaction Payment Created y Transaction Failed para obtener más detalles sobre la implementación, las cargas útiles de muestra y la explicación de todos los parámetros.

   • Cubre tanto los métodos de pago síncronos como los asincrónicos.

2. Recuperar API de transacción:

   • Para obtener más detalles sobre la llamada a la API y sus parámetros, consulte la documentación Recuperar API de transacción en nuestro portal para desarrolladores

#➤ Configuración adicional

Con Viva.com Smart Checkout hemos preparado muchas funciones y herramientas que puedes utilizar y dar a tus clientes más opciones para sus pagos.

• Pagos recurrentes: Un método de pago en el que el comerciante (usted) inicia los cargos automáticamente en un cronograma predefinido sin involucrar al cliente después del primer pago.

• Pre-Autorizaciones: Un método de pago utilizado para verificar la disponibilidad de fondos y reservar el monto, con la transferencia real de fondos iniciada más tarde.

Puedes encontrar guías detalladas en nuestro portal del desarrollador para proceder con todas las configuraciones que puedes realizar a través de tu cuenta para aceptar pagos online, así como explorar todas las alternativas y servicios que ofrecemos.