El cobro ocurre sobre una propuesta con precio cerrado.

AkiVeo+ cobra el precio total de la propuesta, calculado con el catálogo que cargan los laboratorios. Hoy el checkout opera con un medio de pago: VentiPay. La plataforma admite un proveedor activo a la vez y permite conmutarlo desde el panel de administración, sin volver a desplegar.

Dónde está el checkout hoy

Preferimos decirlo antes de conversar: esto es lo que hay construido y lo que todavía no.

  • Un proveedor a la vez

    El checkout opera con un solo medio de pago activo, y la base de datos lo impone: no puede haber dos proveedores activos al mismo tiempo. Hoy ese proveedor es VentiPay.

  • Cobro por el total, en una operación

    El cobro se hace por el monto completo, en pesos chilenos y sin decimales. No hay cuotas, financiamiento diferido ni billeteras implementadas dentro del flujo.

  • Sin reparto de fondos entre actores

    La plataforma cobra el total en una sola transacción. No divide el monto entre óptica y laboratorio.

Para una pasarela que quiera integrarse

  • 01

    Un solo punto de integración

    El checkout se resuelve contra un mismo contrato de pasarela — crear la sesión y verificar el pago — hoy expuesto en dos rutas: la del flujo rápido y la de un pedido pendiente. Cambiar de proveedor no cambia ese contrato.

  • 02

    Cambio de proveedor sin desplegar

    El proveedor activo se lee de la base de datos en cada operación, y un administrador lo conmuta desde el panel. En el checkout del flujo rápido, el nombre que ve el paciente sale de esa misma fila y cambia con ella.

  • 03

    Confirmación verificada, no confiada

    El aviso de VentiPay llega firmado con HMAC-SHA256 y la plataforma rechaza el que no valide, con ventana anti-replay de cinco minutos. En los dos proveedores, antes de marcar algo como pagado vuelve a consultar la transacción contra su API. El límite: la firma de MercadoPago solo se valida si su secreto está cargado, y hoy en producción no lo está.

  • 04

    Cobro sobre una propuesta vigente

    Solo se puede pagar una propuesta que ya tiene precio y no está vencida. El enlace se valida antes de abrir el cobro y el endpoint acepta cinco intentos por minuto.

El recorrido del pago

  1. 01

    Propuesta con precio

    El paciente recibe una propuesta con el precio del par de cristales, calculado con el catálogo que cargan los laboratorios. Sin precio no se abre el pago.

  2. 02

    Apertura del checkout

    La plataforma crea la sesión con el proveedor activo — hoy VentiPay — y lleva al paciente a su pantalla de pago, en pesos chilenos.

  3. 03

    Confirmación

    El proveedor avisa del resultado. La plataforma valida la firma del aviso y vuelve a consultar el pago contra la API del proveedor antes de darlo por aprobado.

  4. 04

    Vuelta al paciente

    Terminada la operación en el checkout del flujo rápido, el paciente vuelve a la pantalla de pago exitoso o de pago fallido según el resultado, en la pestaña donde se abrió el cobro.

Conecte su pasarela al checkout de AkiVeo+ sobre un flujo de cobro ya construido

La integración son tres piezas: crear la sesión de pago, responder con un aviso firmado y contestar una consulta de verificación — la plataforma no da por aprobado un pago sin volver a preguntarlo. El proveedor activo se define por configuración, no por código. Cuotas, billeteras y reparto de fondos todavía no están implementados.