VibeFox CorvusPay for PrestaShop — Ayuda
Requisitos
PrestaShop: de 8.0 a 9.x.
PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.
Moneda: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK o USD. Con cualquier otra moneda del carrito, el método de pago no se muestra en la finalización de compra. Los importes se envían con 2 decimales; un total con más decimales (por ejemplo, en una tienda con precios en BHD de 3 decimales) se rechaza en lugar de redondearse.
Cuenta de CorvusPay: necesitas una cuenta de comerciante de CorvusPay. CorvusPay emite un Store ID y una Secret Key para cada tienda, por separado para la tienda de prueba y la de producción; se muestran en el CorvusPay Merchant Center. La Success URL y la Cancel URL del módulo deben introducirse allí (véase Configuración).
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.
Instalación
1. En el back office, ve a Modules > Module Manager y haz clic en Upload a module. Elige el archivo ZIP del módulo.
2. Cuando termine la subida, haz clic en Configure, o busca más tarde VibeFox CorvusPay Gateway en la lista de módulos y haz clic en Configure.
3. Introduce tu clave de licencia de VibeFox en License key en el bloque de licencia de la parte superior de la página Configure y haz clic en Activate (ver Clave de licencia).
4. Introduce el Store ID y la Secret Key de tu tienda de prueba de CorvusPay (y los de la tienda de producción para los pagos reales). Copia la Success URL y la Cancel URL que aparecen en la página Configure en el CorvusPay Merchant Center, tanto para la tienda de prueba como para la de producción.
5. Activa Enable/Disable y haz clic en Save. Haz un pedido de prueba y, después, desactiva Test Mode para pasar a producción.
Al instalarse, el módulo crea el estado de pedido CorvusPay payment on hold. PrestaShop vincula un nuevo módulo de pago a las monedas, los grupos de clientes y los países activos en ese momento. Puedes cambiarlo en Payment > Preferences; un país que actives más tarde debe marcarse allí para el módulo.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox CorvusPay Gateway > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Encima de los campos, la página muestra El modo de prueba está activado. Los pagos van al entorno de pruebas de CorvusPay: no se cobra dinero real. mientras el modo de prueba está activo; avisa cuando la pasarela está activada pero el Store ID o la Secret Key del modo actual están vacíos (en ese caso no se muestra en la finalización de compra hasta que se completen) y cuando la moneda predeterminada de tu tienda no es compatible con CorvusPay.
CorvusPay
Enable/Disable: Enable CorvusPay Gateway activa o desactiva el método de pago. Predeterminado: desactivado.
Title: el nombre del método de pago que ven los clientes en la finalización de compra. También es el nombre del método de pago que se guarda en el pedido. Predeterminado: Credit/Debit Card (CorvusPay).
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Predeterminado: Pay securely with your credit or debit card via CorvusPay. En modo de prueba se le añade (Modo de prueba: no se cobra ningún pago real.).
Credenciales de la tienda
CorvusPay emite el Store ID y la Secret Key de cada tienda (de prueba y de producción por separado), y se muestran en el CorvusPay Merchant Center.
Test Mode: usa el entorno de pruebas de CorvusPay (wallet.test.corvuspay.com) y el Store ID y la Secret Key de prueba. Predeterminado: activado. Desactívalo para cobrar pagos reales en wallet.corvuspay.com.
Test Store ID: el Store ID numérico de tu tienda de prueba de CorvusPay.
Test Secret Key: la Secret Key de tu tienda de prueba de CorvusPay, que se usa para las firmas HMAC-SHA256.
Live Store ID: el Store ID numérico de tu tienda de producción de CorvusPay.
Live Secret Key: la Secret Key de tu tienda de producción de CorvusPay, que se usa para las firmas HMAC-SHA256.
Clear saved secrets: marca Test Secret Key o Live Secret Key y haz clic en Save para eliminarla.
El Store ID debe contener solo dígitos. Si introduces otra cosa, la página muestra … debe contener solo dígitos; se mantuvo el valor anterior. y los demás campos se guardan igualmente. Las Secret Key guardadas nunca vuelven a mostrarse: el campo queda vacío y muestra Guardada: déjala vacía para conservarla. Escribe un valor nuevo solo si quieres cambiarlo. Un pago siempre se verifica con la Secret Key de la tienda en la que se inició, así que mantén rellenada la clave de prueba mientras aún puedan regresar pagos de prueba.
Success URL y Cancel URL
Copia las dos direcciones que aparecen en esta sección en el CorvusPay Merchant Center, tanto para la tienda de prueba como para la de producción. CorvusPay devuelve al cliente a ellas después del pago. Cópialas exactamente como las muestra la página; con URL amigables tienen el aspecto de los ejemplos siguientes, posiblemente con un código de idioma como /en/.
Pago
Transaction Type: cómo se cobra la tarjeta.
Payment Page Language: el idioma de la página de pago de CorvusPay. Site language (predeterminado) usa el idioma actual de tu tienda cuando CorvusPay lo admite; si no, inglés. También puedes elegir Hrvatski, English, Deutsch, Italiano, Srpski o Slovenščina.
Order Status After Payment: el estado del pedido tras un pago Sale correcto. El pedido se crea directamente en este estado.
Avanzado
Logging: escribe información de depuración en logs/corvuspay_p_debug.log.php, en la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores se registran siempre, incluso cuando esto está desactivado; los secretos, las firmas y los datos de los clientes nunca. Predeterminado: desactivado.
Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.
Delete Data: si está activado, al desinstalar el módulo se eliminan sus ajustes y los archivos de registro. Los pedidos, los datos de transacción de CorvusPay y el estado del pedido siempre se conservan. Predeterminado: desactivado.
Finalización de compra
En el paso de pago, el cliente elige el método de pago (por defecto Credit/Debit Card (CorvusPay)) y confirma. La página siguiente muestra Redirigiendo a CorvusPay para el pago. Espera... y envía el formulario firmado a la página de pago de CorvusPay. Si la redirección no se inicia, el cliente hace clic en Pay via CorvusPay; Back to checkout vuelve a la finalización de compra. Se envían el total del carrito, la moneda, una breve descripción (número de carrito y nombre de la tienda) y los datos de la dirección de facturación y el correo electrónico (para rellenar previamente la página de pago). En este punto todavía no existe ningún pedido. Se reutiliza el mismo número de pedido de CorvusPay mientras no cambien el importe, la moneda, el modo y el tipo de transacción, y CorvusPay no acepta un segundo pago para él.
Después de pagar, CorvusPay devuelve al cliente a la Success URL. El pedido se marca como pagado solo cuando CorvusPay lo confirma: el número de pedido de CorvusPay debe haber sido emitido por esta tienda, la firma debe coincidir con la Secret Key de la tienda en la que se inició el pago, y el importe y la moneda deben coincidir con el carrito. Entonces se crea el pedido y el cliente ve la página estándar de confirmación del pedido con Tu pago de CorvusPay se ha recibido. En Authorize only la página muestra Tu pago de CorvusPay se ha autorizado. El importe se cobrará cuando la tienda procese tu pedido. y, para un pedido en espera, Tu pago se ha recibido y la tienda lo está revisando.
Si el pedido no puede crearse en ese momento (por ejemplo, porque otra solicitud está confirmando el mismo carrito), el cliente ve Tu pago se está confirmando con un botón Check again, que lleva a la confirmación del pedido en cuanto el pedido existe. Si la solicitud a la Success URL no puede verificarse, el cliente ve Pago no confirmado y No hemos podido confirmar este pago de CorvusPay. Si se ha cargado tu tarjeta, ponte en contacto con la tienda; no vuelvas a pagar. No se cambia nada. La Success URL funciona aunque la tienda esté en modo de mantenimiento.
Si el cliente cancela en la página de CorvusPay, vuelve a la finalización de compra con el carrito intacto y El pago de CorvusPay se ha cancelado y el pedido no se ha pagado. Tu carrito sigue aquí: puedes volver a intentarlo o elegir otro método de pago.
Si el pago no puede iniciarse, el cliente permanece en la finalización de compra con un breve mensaje: CorvusPay no está configurado. Elige otro método de pago., CorvusPay no acepta pagos en … o Este total del pedido no puede pagarse mediante CorvusPay (debe ser mayor que cero y tener como máximo 2 decimales). Elige otro método de pago.
El pedido se confirma solo cuando CorvusPay devuelve al cliente a la Success URL; no hay notificaciones de servidor a servidor. Si el cliente cierra el navegador justo después de pagar, no se crea ningún pedido. El módulo no ofrece reembolsos, capturas ni anulaciones desde PrestaShop (la API de servidor de CorvusPay requiere un certificado de cliente), ni tarjetas guardadas, suscripciones, pagos a plazos ni formulario de tarjeta en la propia tienda.
Pedidos
Estados del pedido
Aún sin pedido: el cliente fue enviado a CorvusPay y no ha vuelto con un pago confirmado. Solo existe el carrito. Si el cliente pagó pero no regresó, comprueba el pago en el CorvusPay Merchant Center y crea el pedido manualmente.
Payment accepted, Delivered o CorvusPay payment on hold: se confirmó el pago Sale. El estado sigue a Order Status After Payment. El pago se registra con el ID de transacción de CorvusPay o, si CorvusPay no envía ninguno, con el número de pedido de CorvusPay, con el que el pago puede localizarse en el Merchant Center. Una nota privada del pedido muestra el número de pedido de CorvusPay, el código de aprobación y el tipo de tarjeta.
CorvusPay payment on hold, authorized: está seleccionado Authorize only. Captura el pago en el CorvusPay Merchant Center y después cambia el pedido a Payment accepted.
CorvusPay payment on hold, amount/currency mismatch: el importe o la moneda pagados no coinciden con el carrito, por ejemplo porque el carrito se modificó en otra pestaña. El pago se registra con el importe realmente pagado si está en la moneda del pedido. No envíes el pedido antes de verificar el pago en el CorvusPay Merchant Center.
CorvusPay payment on hold, payment after cancel: llegó un pago correcto para un intento de pago que el cliente había cancelado. Tramita el pedido o reembolsa el pago en el CorvusPay Merchant Center.
Si llega otro pago correcto distinto para un carrito que ya tiene pedido, el pedido no se modifica. Una nota te pide comprobar el CorvusPay Merchant Center y reembolsar el pago duplicado si es necesario.
Bloque de pago de CorvusPay
La página del pedido muestra un bloque CorvusPay payment con el número de pedido de CorvusPay, el estado del intento de pago, el tipo de transacción (Sale o Authorize only), el importe (y el importe recibido, si CorvusPay lo informó), el código de aprobación, la transacción y el tipo de tarjeta. Los pagos de prueba se marcan como Test.
Reembolsos: los reembolsos, las capturas y las anulaciones desde PrestaShop no son compatibles. Hazlos en el CorvusPay Merchant Center y registra el resultado en PrestaShop manualmente.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox CorvusPay Gateway es el primer bloque de Modules > Module Manager > VibeFox CorvusPay Gateway > Configure, por encima de los ajustes. Pega la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para quitar la clave de esta tienda. Debajo de ellos aparece la línea Product: presta-payment-corvuspay y el enlace Gestionar licencias y dominios en tu cuenta, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure del módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (se incluyen inglés y ruso).
Si la clave no es aceptada, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on y una fecha. Después de cambiar la dirección de la tienda, o después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede contactar con el servidor de licencias, el módulo sigue funcionando con el último estado conocido.
Una clave funciona en un solo dominio: el dominio de la tienda principal, también en una configuración multitienda. Quitar la clave de la tienda no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, CorvusPay no se muestra a los clientes en la finalización de compra. Si de todos modos se inicia un pago, el cliente ve Este método de pago no está disponible. Elige otro. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que el método de pago también se oculta para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en la finalización de compra. Aparece un recordatorio en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados: los pagos ya iniciados se siguen confirmando cuando el cliente regresa de CorvusPay.
Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días después de introducir la clave y, después, una vez por semana. No se necesita ninguna tarea programada (cron). Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.
Solución de problemas
CorvusPay no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que el Store ID y la Secret Key del modo actual están rellenados (Test Store ID y Test Secret Key en modo de prueba, Live Store ID y Live Secret Key en modo de producción) y que la moneda del carrito es compatible con CorvusPay. En Payment > Preferences, comprueba que el módulo está permitido para la moneda del carrito, el país del cliente y el grupo del cliente.
El pago se realizó, pero no se creó ningún pedido: probablemente la Success URL no está introducida en el CorvusPay Merchant Center, o la Secret Key de PrestaShop no coincide con la tienda. Busca INVALID signature en el campo Log de la página del módulo (los errores siempre se registran). Tampoco se crea pedido si el cliente cerró el navegador antes de volver; en ese caso, comprueba el pago en el Merchant Center y crea el pedido manualmente.
El cliente ve Pago no confirmado: la solicitud a la Success URL fue rechazada: faltaban campos obligatorios, el número de pedido de CorvusPay no lo emitió esta tienda, la Secret Key de esa tienda está vacía o la firma no coincidió. No se cambia nada. El registro muestra el motivo.
El cliente ve Tu pago se está confirmando durante mucho tiempo: no se pudo crear el pedido, por ejemplo porque el módulo estaba desactivado o el carrito ya no es válido. El registro muestra el motivo; comprueba el pago en el Merchant Center.
El cliente ve Este total del pedido no puede pagarse mediante CorvusPay: el total es cero o tiene más de 2 decimales.
El cliente ve CorvusPay no está configurado o CorvusPay no acepta pagos en …: falta el Store ID o la Secret Key del modo actual, o la moneda del carrito no es compatible.
El pedido está en CorvusPay payment on hold: lee las notas privadas del pedido. Está seleccionado Authorize only, el importe o la moneda pagados no coincidieron con el carrito, el pago llegó después de que el cliente cancelara, o Order Status After Payment está configurado como en espera.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox CorvusPay Gateway y elige Uninstall. La clave de licencia y el estado de licencia de este módulo siempre se eliminan. Si Delete Data está activado, se eliminan los ajustes del módulo y los archivos de registro. Si está desactivado, se conservan todos los ajustes para una reinstalación posterior. Los datos de transacción de CorvusPay y el estado del pedido CorvusPay payment on hold siempre se conservan, de modo que el bloque de CorvusPay de los pedidos antiguos vuelve a aparecer tras una reinstalación. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
CorvusPay es una marca comercial de su respectivo propietario. Este módulo no está afiliado ni respaldado por CorvusPay.