Magento puede ser exigente. Las configuraciones de pago también. Si te preguntas cómo conectar Payora con Magento, empieza por decidir si estás trabajando con Magento 2 o Adobe Commerce, porque las pantallas de administración son lo bastante parecidas como para confundir a cualquiera y lo bastante distintas como para hacerte perder una hora.
Esta guía encaja con tiendas en las que puedes acceder al panel de administración, editar métodos de pago y cambiar ajustes del módulo sin tener que esperar a un desarrollador en cada paso. Si tu tienda funciona con permisos restringidos, consigue acceso temporal primero. Un solo rol que falte puede bloquear todo el proceso.
1. Confirma que esta es la configuración de Magento adecuada para Payora
Usa este camino si tu tienda está en Magento 2 o Adobe Commerce y puedes instalar o activar un módulo de pago. Las versiones antiguas de Magento suelen requerir un enfoque de mantenimiento diferente, y lo mismo ocurre si tu proceso de compra está muy personalizado. Una anulación del tema puede ocultar el método de pago incluso cuando el módulo está activo.
Antes de tocar los ajustes de pago, comprueba quién es responsable de tres cosas: el código base, la configuración de pagos y el endpoint del webhook. Si alguna de ellas depende de un tercero, necesitas su aprobación. Suena burocrático hasta que una compra en producción se rompe a las 6 p. m.
Para equipos que comparan opciones, Payora encaja con tiendas que quieren pagos con criptomonedas en Magento sin obligarlas a rediseñar por completo el checkout. Si todavía estás decidiendo cómo se comportará Payora en el sitio, lee también la guía sobre ¿qué es una pasarela de pago cripto?; ayuda a definir si necesitas pago directo en el checkout, pago tipo factura o ambos. Si estás evaluando cómo configurar pasarela de pago cripto en Magento, esta es la base para decidir el alcance antes de tocar el panel.
2. Reúne los datos de pago de Magento que Payora va a necesitar
Antes de la instalación, recopila los valores exactos que te pedirá el módulo. Como mínimo, espera claves API, un identificador de comerciante, una URL de callback o webhook y los ajustes de tienda o moneda que piensas usar. Que falte un solo campo suele traducirse en guardar pruebas una y otra vez y en registros confusos.
Anota los valores una sola vez. Luego revísalos otra vez. Un error en minúsculas en la URL de un endpoint puede impedir que la confirmación del pago llegue nunca a Magento, y ese fallo parece “pago pendiente” hasta que alguien revisa los logs.
Usa la convención de nombres del equipo de pagos si existe. Si la cuenta de comerciante se comparte entre varias tiendas, etiqueta cada vista de tienda con claridad. Si no, la primera solicitud de reembolso se convertirá en un juego de adivinanzas.
Muchas tiendas también definen aquí las reglas de moneda. Si tu catálogo usa USD pero el checkout debe mostrar EUR para una vista de tienda, confirma que Payora y Magento coinciden en la lista de monedas admitidas. Un solo desajuste y el método de pago puede desaparecer en el checkout sin una advertencia clara.
3. Instala o activa el módulo de pago Payora en Magento
La configuración de una pasarela de pago en Magento suele empezar por los archivos del módulo, no por la pantalla de ajustes. Coloca la extensión donde tu proceso de despliegue la espera y luego ejecuta el paso estándar de actualización o activación que use tu equipo. Si tu sitio se gestiona con Composer, mantén la versión alineada con el resto del código de la tienda. En la práctica, esto equivale a instalar módulo Payora Magento 2 con el mismo cuidado con el que despliegas cualquier componente crítico.
Después del despliegue, abre Admin y comprueba si el módulo aparece en los métodos de pago. Necesitas una prueba en la interfaz, no solo un log de despliegue en verde. Si el módulo está presente en el código pero no aparece en Admin, Magento todavía no lo ha registrado del todo.
Algunas tiendas también necesitan vaciar la caché o reindexar la configuración antes de que el método aparezca. No adivines. Ejecuta la misma lista de comprobación posterior al despliegue que usáis para cualquier nuevo método de pago, luego actualiza la página de ajustes de pago y busca Payora por nombre.
Si necesitas una referencia sobre los campos del lado del desarrollador y el comportamiento de callback, la página de documentación para desarrolladores, API de pasarela de pago cripto es el lugar para verificar los nombres exactos de la API. Aquí importan mucho las pequeñas diferencias entre campos.
4. Completa la configuración de la pasarela de pago en Magento desde Admin
Abre el área de configuración de pagos y completa primero los ajustes básicos. Elige el modo de entorno correcto, introduce el título que verán los clientes y confirma que el método de pago esté activado para la vista de tienda correspondiente. Esta es la parte que la mayoría de los equipos hace con prisas, y luego se nota más adelante.
Configura con cuidado las monedas permitidas. Si la tienda vende en 2 monedas, ambas deben estar aceptadas por la pasarela y permitidas en la configuración de la pasarela de pago de Magento. Si una moneda no es compatible, desactívala aquí en lugar de dejar que los clientes descubran el problema en el checkout.
El mapeo de estados del pedido merece atención. Un pedido pagado no debería quedar con el mismo estado que uno no pagado. Asigna el estado inicial, el estado de pago confirmado y cualquier estado de revisión manual para que el equipo de soporte pueda leer la línea de tiempo de un vistazo.
Las reglas de visualización son simples, pero útiles. Limita Payora a las páginas de checkout donde tenga sentido y mantenlo fuera de solicitudes de presupuesto o pedidos internos de administrador, salvo que tengas un flujo de trabajo específico. A un comerciante con el que trabajé se le quedó visible en todas partes, y soporte pasó una semana respondiendo preguntas sobre por qué los pedidos del personal parecían pedidos de clientes.
5. Configura los pagos cripto de Magento para tu flujo de checkout
Ahora importa la experiencia de pago en sí. En pagos con criptomonedas en Magento, el cliente normalmente elige Payora, ve las instrucciones y luego envía los fondos mediante el flujo de pago que proporciona la pasarela. Mantén esa secuencia corta. La gente abandona rápido las páginas de pago largas.
Decide dónde aparecerán las instrucciones de pago después del checkout. Algunas tiendas las colocan en la página de confirmación del pedido; otras envían al cliente a una página de pago dedicada. En cualquier caso, el cliente debe ver con claridad el importe, el activo de pago y el plazo de tiempo. Si esos detalles están ocultos tras un segundo inicio de sesión, espera tickets de soporte.
Después de crear la factura, Magento debería mostrar el pedido como pendiente hasta que Payora confirme el pago. Ese período de espera es normal. No lo marques como en proceso demasiado pronto, o el equipo financiero tendrá que revertirlo después.
Si tu tienda gestiona suscripciones o compradores recurrentes, mantén un lenguaje sencillo en el pago. “Pagar con Payora” funciona mejor que una descripción técnica que solo entiende tu equipo de operaciones. El cliente quiere completar un pago, no estudiar un protocolo.
6. Configura la gestión de pedidos, facturas y estados
La gestión de pedidos es donde los módulos de pago demuestran su valor. Decide qué pasa cuando Payora confirma el pago, cuando un pago expira y cuando un cliente cancela a mitad del proceso. Si la pasarela envía un callback correcto pero Magento mantiene el pedido como pendiente, el mapeo está mal.
Define las reglas de creación de facturas antes de salir a producción. Algunas tiendas crean la factura solo después de confirmar el pago; otras la crean antes por motivos contables. Cualquiera de las dos opciones puede funcionar, pero la regla debe quedar fijada con antelación para que soporte no improvise sobre pedidos reales.
Los pagos fallidos necesitan su propio recorrido. Si Payora informa de un fallo, Magento no debería conservar indefinidamente una etiqueta obsoleta de “en espera de pago”. Cierra el ciclo con un estado fallido o cancelado y luego asegúrate de que el cliente pueda volver a intentarlo sin crear pedidos duplicados.
Para gestionar los callbacks y las comprobaciones de seguridad, merece la pena leer el artículo sobre mejores prácticas de seguridad para pasarelas de pago cripto. Un webhook firmado y un origen verificado son detalles aburridos. También frenan la mayoría de los intentos de fraude de pago.
Una cosa más: los reembolsos y las devoluciones deben seguir un flujo distinto al de la confirmación del pago. Si tu equipo de operaciones emite reembolsos manualmente, documenta el número de pasos y la persona responsable. Un reembolso sin trazabilidad se convierte en una tarde larga.
7. Prueba el checkout de Payora desde el carrito hasta el pedido pagado
Haz al menos una prueba completa desde el carrito hasta el pedido pagado. Usa un sandbox si Payora lo ofrece, o una prueba controlada en producción si tu equipo aprueba ese camino. Quieres ver la página de checkout, las instrucciones de pago, el callback y el estado actualizado del pedido en Admin.
Empieza con un producto de bajo riesgo. Añádelo al carrito, avanza por el checkout y observa que el método de pago aparezca exactamente donde esperas. Si Payora no aparece, normalmente el problema es una bandera de configuración, un desajuste de moneda o un ajuste de vista de tienda.
Después vigila la parte de administración. Una prueba correcta debería producir un cambio de estado y, a menudo, también una factura o un registro de pago. Si la tienda dice “pagado” pero Magento sigue diciendo “pendiente”, detente y revisa el log del callback antes de volver a intentarlo.
Prueba también un escenario de expiración. Deja que venza una ventana de pago y confirma que el pedido no se queda a medias para siempre. Los pedidos muertos se acumulan rápido, y los equipos de soporte odian limpiarlos uno por uno.
Si tu equipo da soporte a más de una plataforma, la lógica del checkout puede sonar familiar. El flujo de aceptar pagos cripto en WordPress usa comprobaciones de confirmación similares, aunque la gestión desde Admin de Magento tiene vida propia.
8. Soluciona problemas comunes de conexión con Magento
Los bloqueos habituales no tienen glamour. URL de callback incorrecta. Activación del módulo ausente. Moneda no coincidente. Método de pago desactivado en la vista de tienda equivocada. Cada uno crea un síntoma distinto, y todos se pueden resolver en cuanto dejas de asumir que la pasarela está rota.
Si los callbacks nunca llegan, prueba el endpoint directamente y confirma que tu servidor acepta solicitudes entrantes desde el entorno de Payora que configuraste. Una regla de firewall puede bloquearlo todo mientras el administrador de Magento sigue pareciendo sano. Esa es la peor clase de “sano”.
Si el método de pago aparece en Admin pero no en el checkout, revisa las reglas de visibilidad y las condiciones de la cotización. Algunas tiendas ocultan métodos de pago según el total del carrito, el país de envío o el grupo de clientes. Un solo filtro oculto basta para hacer desaparecer Payora.
Si la sincronización del estado de pago va con retraso, revisa de nuevo el mapeo del estado del pedido y compáralo con la respuesta de la pasarela. Puede que el código esté bien, pero la tienda podría estar esperando un valor de estado que Payora nunca envía. Ese desajuste es común en proyectos de configuración de pasarela de pago en Magento donde la primera configuración se copió de otra tienda y nunca se limpió.
Para nombres de campos de la API, comportamiento del endpoint y cualquier formato de solicitud específico de la tienda, mantén abierta la página de documentación para desarrolladores, API de pasarela de pago cripto mientras investigas. Un solo parámetro que falte puede bloquear todo el flujo.
Aquí tienes una lista práctica que puedes ejecutar en 10 minutos:
- Confirma que el módulo Payora está activado en la vista de tienda correcta de Magento.
- Verifica que la URL de webhook o callback coincida con el entorno en producción.
- Comprueba que las monedas permitidas incluyen la moneda del checkout.
- Confirma que el mapa de estados del pedido coincide con los valores reales de respuesta de Payora.
- Haz un pedido de prueba y observa las actualizaciones tanto en la tienda como en Admin.
Si la tienda usa varios administradores, limita quién puede cambiar la configuración de pagos. Que dos personas editen la misma pasarela el mismo día es la receta para que unos “arreglos” temporales se conviertan en errores permanentes. Mantén un responsable, o al menos un aprobador.
Magento es estricto, pero eso puede ayudar. Una vez instalado el módulo, completados los ajustes y verificados los callbacks, Payora funciona de forma predecible en el flujo de checkout, que es exactamente lo que la mayoría de los comercios quiere de un método de pago.
Comentarios