VibeFox Culqi for PrestaShop

Descripción general

VibeFox Culqi Payment añade Culqi, el servicio de pagos de Perú, a PrestaShop. En el paso de pago, el cliente paga con tarjeta o Yape en la ventana emergente de Culqi Checkout y nunca sale 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 cobro con la Culqi Charges API, y el pedido se crea solo cuando Culqi confirma el cobro, así que los pagos rechazados o abandonados no dejan pedidos sin pagar.

Es adecuado para tiendas de Perú que venden en sol peruano (PEN) o dólar estadounidense (USD) y tienen una cuenta de Culqi. El módulo acepta solo pagos únicos con tarjeta y Yape. No tiene códigos PagoEfectivo ni CIP, app 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 emergente de Culqi Checkout: tarjetas (Visa, Mastercard, American Express, Diners Club) y, opcionalmente, Yape en una ventana de tu página de finalización de compra.

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

Pagado solo cuando Culqi lo confirma: el pedido se crea cuando Culqi responde con un cobro correcto, y el importe y la moneda cobrados se comparan con el carrito. Si no coinciden, el pedido pasa a Culqi payment on hold con una nota.

Sin cobros duplicados: un carrito que ya tiene un pedido o un cobro 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 con otra tarjeta. El código de rechazo se escribe en el registro del módulo.

Modos de prueba y en vivo: claves pública y secreta separadas 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 el bloque Culqi payment del pedido, hasta el importe que Culqi realmente cobró. Un reembolso total pone el pedido en Refunded.

Ajustes seguros y registro: las claves con un prefijo incorrecto se rechazan, y las claves secretas guardadas nunca se vuelven a mostrar. Registro opcional sin claves, datos de tarjeta ni datos del cliente.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 o posterior. Moneda de la tienda PEN o USD. Una cuenta de Culqi con claves de API pública y secreta. Una clave de licencia de VibeFox de vibefox.net (una clave por dominio).