VibeFox Culqi for OpenCart

Descripción general

VibeFox Culqi Payment añade Culqi, el servicio de pagos peruano, a OpenCart 3 y OpenCart 4. En el último paso de la compra, el cliente hace clic en Confirm Order y paga con tarjeta o Yape en la ventana emergente Culqi Checkout, sin salir de tu tienda. Los datos de la tarjeta se introducen en la ventana de Culqi y nunca llegan a tu servidor. Después, tu servidor crea el cargo con la API de cargos de Culqi (Culqi Charges API). OpenCart crea el pedido antes del pago, pero el pedido solo recibe un estado cuando Culqi confirma el cargo, así que los pagos rechazados o abandonados se quedan como pedidos sin estado.

Encaja con tiendas de Perú que venden en soles peruanos (PEN) o dólares estadounidenses (USD) y que tienen una cuenta de Culqi. La extensión solo acepta pagos únicos con tarjeta y Yape. No incluye aplicación bancaria, agentes, monederos ni Cuotéalo, ni tarjetas guardadas, suscripciones o cuotas, ni webhooks de Culqi, ni autorización y captura por separado.

Características principales

Ventana de Culqi Checkout: tarjetas (Visa, Mastercard, American Express, Diners Club) y, opcionalmente, Yape en una ventana en el paso de confirmación de tu finalización de compra.

3-D Secure: cuando el banco lo exige, se abre automáticamente Culqi 3-D Secure y el cargo se completa tras la autenticación.

Pagado solo cuando Culqi lo confirma: el estado del pedido se asigna después de que Culqi responda con un cargo correcto, y el importe y la moneda cobrados se comparan con el pedido. Si no coinciden, el pedido pasa a un estado de revisión con una nota. Después, OpenCart envía sus correos habituales de pedido.

Sin cargos duplicados: un pedido que ya tiene un cargo de Culqi nunca se vuelve a cobrar, ni siquiera tras un doble clic, una segunda pestaña o un reintento.

Rechazos claros: el cliente ve el mensaje de Culqi y puede probar otra tarjeta en el mismo paso. Una nota en el pedido y el registro guardan el código de rechazo.

Modos de prueba y de producción: claves públicas y secretas independientes para cada modo. Los reembolsos siempre usan las claves del modo en el que se hizo el pago.

Reembolsos desde la página del pedido: reembolsos totales y parciales en la pestaña VibeFox Culqi Payment del pedido, hasta el importe que Culqi cobró realmente. Un reembolso total asigna el estado Refunded.

Condiciones de OpenCart y ajustes seguros: zona geográfica, importe mínimo del pedido, orden de visualización y tus propios estados de pedido. Las claves con un prefijo incorrecto se rechazan y las claves secretas guardadas no vuelven a mostrarse. Registro opcional, sin claves, datos de tarjeta ni datos de clientes.

Requisitos

OpenCart 3.0.x (probado con la versión 3.0.5.0) o OpenCart 4.0.2 y posteriores (probado con la versión 4.1.0.3), PHP 8.0 o posterior. La descarga incluye los paquetes para ambas versiones. Una moneda activada en la tienda: PEN o USD. Una cuenta de Culqi con claves de API públicas y secretas. Una clave de licencia de VibeFox de vibefox.net (una clave por dominio).