Skip to main content
Beta. Este plugin está completo en funciones y revisado en código, pero aún no se ha verificado contra una instalación de Shopware en vivo. Ver Limitaciones conocidas abajo antes de confiar en él, y prueba a fondo en tu propio entorno de staging.
El plugin de Therius para Shopware 6 reemplaza las integraciones estándar de pasarela única con el Widget de checkout, soportando tarjetas y métodos de pago alternativos locales con enrutamiento inteligente. Repositorio: therius-pay/therius-plugin-shopware

Requisitos

  • Shopware 6 con acceso de admin para instalar extensiones
  • Una cuenta de Therius con claves de API y una configuración de checkout

Instalación

  1. Descarga el .zip del plugin.
  2. En el admin de Shopware, ve a Extensiones → Mis extensiones → Subir extensión y sube el .zip.
  3. Haz clic en Instalar, luego en Activar.

Configuración

Comportamiento del checkout

Seleccionar Therius Payments en la página de confirmación no renderiza un formulario de tarjeta inline. Hacer clic en Completar pedido abre el Widget de checkout de Therius en un lightbox, obteniendo una sesión de checkout fresca en ese momento. Cualquier paso adicional que necesite el pago — un desafío de 3D Secure, un redirect de APM, un paso de verificación por microdepósito — ocurre dentro de ese mismo lightbox. Shopware solo crea la orden una vez que el pago tuvo éxito.

Webhooks

Configura esto antes de tomar pagos en vivo. Sin ello, los pagos que requieren validación asíncrona quedan pendientes y los reembolsos hechos desde el dashboard de Therius no se reflejan en Shopware.
  1. En el dashboard de Therius, ve a Developers → Webhooks y agrega un endpoint que apunte a:
    Crea un endpoint en modo Sandbox y uno en modo Producción si usas ambos.
  2. Suscríbete a: payment.authorized, payment.captured, payment.refused, payment.refunded, payment.refund_failed, payment.cancelled, payment.chargeback, payment.capture_failed, payment.cancel_failed.
  3. Copia el secreto de firma de cada entorno en el campo correspondiente Test Webhook Secret / Live Webhook Secret de la configuración del plugin.

Limitaciones conocidas

Las actualizaciones de orden impulsadas por webhook no funcionan en la build actual. El plugin coincide los webhooks entrantes contra el número de orden de Shopware, pero el identificador que envía a Therius en el momento del cobro es el token del carrito, no el eventual número de orden — así que las entregas para órdenes reales no coinciden y se registran como “unknown order”. Hasta que se corrija esto, las capturas, los reembolsos, los contracargos y las cancelaciones realizados desde el dashboard de Therius no actualizan el estado de la orden de Shopware. Se espera que los reembolsos se inicien desde el dashboard de Therius en vez del admin de Shopware.