AOS Pulse añade al catálogo de servicios de AOS Palace la posibilidad de pagar directamente con tarjeta o mediante PayPal, sin salir del entorno del congreso. Cuando un participante elige cualquiera de estas pasarelas, el sistema le redirige a la pantalla de pago segura y, al completar el pago, regresa automáticamente con el pedido ya confirmado.
Sin AOS Pulse, el único método disponible es la transferencia bancaria manual, que requiere que el administrador revise el comprobante y confirme el pedido a mano. Con AOS Pulse, todo ese proceso se automatiza para los pagos con tarjeta o PayPal.
Cómo se integra con AOS Palace Core
AOS Pulse se conecta al Core de forma transparente. Las pasarelas activas aparecen automáticamente como opciones de pago en el catálogo de servicios. El participante elige el método al hacer el checkout, igual que con la transferencia bancaria, pero en lugar de recibir datos de IBAN recibe la redirección a la pantalla de pago segura.
AOS Pulse y la transferencia bancaria son compatibles y complementarios. Puedes tener activas las tres pasarelas y la transferencia al mismo tiempo. El participante elige en el checkout qué método prefiere.
| Componente | Requisito | Notas |
|---|---|---|
| AOS Palace Core | Activo y con licencia | Obligatorio. AOS Pulse no funciona sin él. |
| WordPress | 6.0 o superior | Se recomienda la última versión estable |
| PHP | 7.4 o superior | Se recomienda PHP 8.1+ |
| HTTPS | Obligatorio en producción | Las pasarelas de pago requieren conexión cifrada. Sin SSL, los pagos reales no se pueden activar. |
| Licencia AOSYS | Activa | Sin licencia activa el panel de ajustes está disponible pero el procesamiento de pagos queda bloqueado. |
| Cuenta en la pasarela | Una por pasarela que quieras activar | Necesitas cuenta en Stripe, PayPal o Redsys (según las que uses). Ver sección de cada pasarela. |
Si la licencia de AOS Pulse no está activa, el botón de pago desaparece del proceso de checkout y los participantes solo pueden usar transferencia bancaria. El acceso al panel de configuración permanece disponible para que puedas introducir la clave de licencia.
-
Verifica que AOS Palace Core está activo
Antes de instalar AOS Pulse, asegúrate de que AOS Palace Core está instalado, activo y con su licencia configurada.
-
Instala el plugin
Ve a Plugins → Añadir nuevo → Subir plugin, selecciona el archivo
.zipde AOS Pulse y haz clic en Instalar ahora. Después actívalo. -
Activa la licencia
Ve a AOS Palace → AOS Pulse → Licencia, introduce tu clave de licencia AOSYS y actívala. La pestaña de pasarelas permanece oculta hasta que la licencia esté activa.
-
Configura al menos una pasarela
Ve a AOS Palace → AOS Pulse → Pasarelas y configura las credenciales de la pasarela que quieras usar. Consulta la sección correspondiente a cada una en este manual.
-
Prueba en modo sandbox antes de activar producción
Todas las pasarelas ofrecen un entorno de prueba. Realiza al menos un pago de test completo antes de activar el modo de producción (cobros reales).
La instalación está completa cuando el menú AOS Pulse aparece dentro de AOS Palace en el panel de WordPress y ves al menos una pasarela marcada como activa en el listado de configuración.
Stripe es la pasarela de pago más utilizada para tarjetas de crédito y débito internacionales. El participante es redirigido a la pantalla segura de Stripe Checkout, donde introduce sus datos de tarjeta, y regresa automáticamente al congreso con el pago confirmado.
¿Qué necesitas antes de configurar Stripe?
Una cuenta en stripe.com (gratuita para crear, se cobra por transacción). Desde el panel de Stripe necesitarás obtener las claves de la sección Desarrolladores → Claves de API y crear un webhook.
Campos de configuración
| Campo | Descripción | Dónde encontrarlo |
|---|---|---|
| Habilitar Stripe | Activa o desactiva este método de pago en el checkout del congreso | Checkbox en el panel de AOS Pulse |
| Nombre del método de pago | El texto que verá el participante al elegir este método (ej. "Tarjeta de Crédito") | Campo libre — personalizable |
| Clave Pública | Identifica tu cuenta Stripe ante el navegador del participante. Empieza por pk_live_ (producción) o pk_test_ (pruebas). | Panel Stripe → Desarrolladores → Claves de API |
| Clave Secreta | Clave privada que autoriza las llamadas al servidor de Stripe. Empieza por sk_live_ o sk_test_. Nunca se muestra de nuevo una vez guardada. | Panel Stripe → Desarrolladores → Claves de API |
| Webhook Signing Secret | Clave que verifica que las notificaciones de Stripe son auténticas. Empieza por whsec_. | Panel Stripe → Desarrolladores → Webhooks (al crear el endpoint) |
Cómo crear el webhook en Stripe
-
Accede a Stripe → Desarrolladores → Webhooks
En el panel de Stripe, ve al menú lateral Desarrolladores y selecciona Webhooks. Haz clic en Añadir endpoint.
-
Introduce la URL del endpoint de AOS Pulse
Copia la URL que aparece en el panel de configuración de Stripe en AOS Pulse (visible cuando el campo Webhook Signing Secret está vacío):
URL del Webhook — Stripehttps://tu-sitio.com/wp-json/aos-pulse/v1/webhook/stripe -
Selecciona el evento a escuchar
En el selector de eventos, elige únicamente checkout.session.completed. Este es el único evento que AOS Pulse necesita para confirmar los pedidos.
-
Copia el Signing Secret y guárdalo en AOS Pulse
Al crear el webhook, Stripe mostrará el Webhook Signing Secret (empieza por whsec_). Cópialo y pégalo en el campo correspondiente en AOS Pulse antes de cerrar esa pantalla, ya que no podrás verlo de nuevo.
Para las pruebas, usa las claves de modo test de Stripe (pk_test_ / sk_test_) y activa el webhook en modo test con el mismo endpoint. Stripe dispone de tarjetas de prueba para simular pagos exitosos y fallidos sin coste.
Nunca compartas la Clave Secreta ni el Webhook Signing Secret con nadie. Si los has expuesto accidentalmente, revócalos inmediatamente desde el panel de Stripe y genera unos nuevos.
La integración con PayPal usa la API REST v2 de PayPal. El participante es redirigido al portal de PayPal, donde puede pagar con su cuenta PayPal o con tarjeta sin cuenta. Al completar el pago, regresa automáticamente al congreso con el pedido confirmado.
¿Qué necesitas antes de configurar PayPal?
Una cuenta de empresa en paypal.com y acceso al panel de desarrolladores en developer.paypal.com. Desde allí deberás crear una aplicación para obtener las credenciales.
Campos de configuración
| Campo | Descripción | Dónde encontrarlo |
|---|---|---|
| Habilitar PayPal | Activa o desactiva este método en el checkout del congreso | Checkbox en AOS Pulse |
| Nombre del método de pago | El texto que verá el participante al elegir este método (ej. "PayPal") | Campo libre — personalizable |
| Client ID | Identificador público de tu aplicación PayPal | developer.paypal.com → Mis apps → Tu app → Client ID |
| Secret Key | Clave privada de la aplicación. Nunca se muestra de nuevo una vez guardada. | developer.paypal.com → Mis apps → Tu app → Secret |
| Webhook ID | Identificador del webhook registrado en PayPal para recibir notificaciones | developer.paypal.com → Mis apps → Tu app → Webhooks |
| Entorno | Sandbox para pruebas · Live para producción (cobros reales) | Selector en AOS Pulse |
Cómo crear las credenciales en PayPal
-
Accede a developer.paypal.com y ve a "Mis apps"
Inicia sesión con tu cuenta de empresa de PayPal en el portal de desarrolladores. Selecciona Dashboard → Mis apps y credenciales.
-
Crea una nueva aplicación
Haz clic en Crear aplicación, dale un nombre (ej. "AOS Palace Congreso") y elige el tipo Merchant. Elige el entorno Sandbox para empezar.
-
Copia el Client ID y el Secret
La pantalla de la aplicación muestra el Client ID (visible siempre) y el Secret (haz clic en Mostrar para verlo). Cópialos en AOS Pulse.
-
Registra el webhook
En la misma pantalla de la aplicación, desplázate hasta Webhooks y añade uno nuevo con la URL de AOS Pulse y el evento CHECKOUT.ORDER.APPROVED:
URL del Webhook — PayPalhttps://tu-sitio.com/wp-json/aos-pulse/v1/webhook/paypal -
Copia el Webhook ID en AOS Pulse
Tras crear el webhook, PayPal asigna un identificador único (Webhook ID). Cópialo en el campo correspondiente de AOS Pulse.
PayPal ofrece cuentas sandbox de prueba (buyer y seller) en el portal de desarrolladores. Úsalas para simular pagos completos antes de pasar a producción. Cuando estés listo, crea las credenciales en el entorno Live y cambia el selector de entorno en AOS Pulse.
Redsys es el sistema de pago por TPV virtual más utilizado en España, respaldado por los principales bancos españoles. El participante es redirigido a la pasarela segura del banco, introduce sus datos de tarjeta y regresa al congreso con el pedido confirmado.
¿Qué necesitas antes de configurar Redsys?
Un contrato de TPV virtual con tu banco o entidad financiera española. El banco te proporcionará los datos de comercio (FUC, terminal y clave secreta) necesarios para la integración. Redsys dispone de un entorno de pruebas (Sandbox) en sis-t.redsys.es.
Campos de configuración
| Campo | Descripción | Dónde encontrarlo |
|---|---|---|
| Habilitar Redsys | Activa o desactiva este método en el checkout del congreso | Checkbox en AOS Pulse |
| Nombre del método de pago | El texto que verá el participante (ej. "Pago con Tarjeta — TPV Virtual") | Campo libre — personalizable |
| FUC Comercio | Número de identificación de tu comercio ante Redsys (8 dígitos) | Facilitado por tu banco al contratar el TPV virtual |
| Terminal | Número de terminal del TPV. Habitualmente es 1 (o 001). | Facilitado por tu banco. Por defecto: 1 |
| Clave Secreta de Encriptación | Clave SHA256 para firmar y verificar las transacciones. Nunca se muestra de nuevo una vez guardada. | Panel de administración de Redsys o facilitada por el banco |
| Entorno | Sandbox para pruebas (sis-t.redsys.es) · Live para producción (sis.redsys.es) | Selector en AOS Pulse |
Notificación de pago (webhook automático)
A diferencia de Stripe y PayPal, la URL de notificación de Redsys se configura automáticamente en cada solicitud de pago — no es necesario registrarla manualmente en ningún panel. AOS Pulse incluye en cada operación la URL donde Redsys enviará la confirmación:
Para las pruebas con Redsys Sandbox, el banco o Redsys te proporcionará tarjetas de test. El entorno de pruebas (sis-t.redsys.es) es completamente funcional y gratuito para testear el flujo completo antes de la activación en producción.
La Clave Secreta de Encriptación es el dato más sensible de Redsys. Cualquier persona que la conozca podría falsificar transacciones. Trátala con el mismo cuidado que una contraseña de banco.
El proceso de pago es idéntico para las tres pasarelas desde el punto de vista del participante. El sistema gestiona internamente las diferencias de cada proveedor.
El flujo de confirmación está diseñado para ser resistente a fallos de red. Si el participante cierra el navegador antes de regresar, el webhook de la pasarela confirma el pedido igualmente cuando llega al servidor. El administrador no necesita hacer nada manualmente.
Cuando AOS Pulse confirma un pago, se desencadena automáticamente una cadena de acciones coordinadas con AOS Palace Core y las demás extensiones instaladas:
La confirmación automática solo funciona para pedidos de la edición activa. Si el congreso ha archivado una edición y alguien intenta completar un pago pendiente de esa edición, AOS Pulse rechaza la confirmación y registra el incidente. Esto protege la integridad de los datos entre ediciones.
Todas las pasarelas de AOS Pulse ofrecen un entorno de pruebas (sandbox) completamente separado del entorno real. Úsalo siempre antes de activar los cobros reales.
Resumen de entornos por pasarela
| Pasarela | Modo prueba | Cómo activarlo | Cobros reales |
|---|---|---|---|
| Stripe | Usa claves pk_test_ / sk_test_ y un webhook en modo test | Introduce claves de test en AOS Pulse. No hay selector de entorno; el modo lo determinan las propias claves. | Al cambiar a claves pk_live_ / sk_live_ |
| PayPal | Selector Sandbox en AOS Pulse + credenciales de la app en modo sandbox | Selector → Sandbox en AOS Pulse. Usa las credenciales de la app sandbox de developer.paypal.com | Selector → Live + credenciales de la app live |
| Redsys | Selector Sandbox → conecta con sis-t.redsys.es | Selector → Sandbox en AOS Pulse. Usa las mismas credenciales de tu banco (FUC, terminal, clave). | Selector → Live → conecta con sis.redsys.es |
Cómo verificar que una prueba ha funcionado correctamente
-
Realiza un pago completo con datos de prueba
Usa una tarjeta de test (Stripe: 4242 4242 4242 4242 con cualquier fecha futura y CVC; PayPal: cuenta sandbox buyer; Redsys: tarjeta facilitada por el banco) y completa el proceso como lo haría un participante real.
-
Verifica que el pedido aparece como confirmado
En AOS Palace → Participantes → ficha del participante de prueba → Historial de pedidos, el pedido debe aparecer con estado Confirmado y el método de pago correcto.
-
Comprueba que llegó el email de confirmación
El email configurado en AOS Palace Core debe haber llegado al email del participante de prueba.
-
Si todo es correcto, activa el modo de producción
Cambia al entorno Live en AOS Pulse e introduce las claves de producción. A partir de ese momento los participantes realizarán cobros reales.
Nunca mezcles claves de prueba con el entorno de producción ni al revés. Si introduces claves de test cuando el selector está en Live (o viceversa), los pagos fallarán o podrían generar incidencias con la pasarela.
AOS Pulse registra internamente cada transacción procesada con sus datos esenciales. Esto complementa el historial de pedidos de AOS Palace Core y permite tener trazabilidad de qué pasarela procesó cada pago.
Dónde consultar los pagos
Hay dos lugares donde puedes ver el estado de los pagos procesados por AOS Pulse:
| Dónde | Qué muestra | Cómo acceder |
|---|---|---|
| Ficha del participante en AOS Palace | Historial de pedidos con el método de pago registrado (Stripe, PayPal, Redsys o transferencia). Estado del pedido y enlace a la factura. | AOS Palace → Participantes → seleccionar participante → Historial de pedidos |
| Panel de la pasarela correspondiente | Detalle completo de cada transacción: importe exacto, datos del pagador, estado del pago, posibles disputas o reembolsos. | Panel de Stripe, PayPal o el portal de Redsys de tu banco |
Para la gestión contable y fiscal, el panel de la pasarela correspondiente (Stripe Dashboard, panel de PayPal, portal Redsys) es la fuente más completa y fiable. Desde allí también puedes gestionar posibles devoluciones o disputas directamente.
Reembolsos
AOS Pulse no dispone actualmente de un botón de reembolso directo desde el panel de WordPress. Para devolver un cobro a un participante, realiza el reembolso directamente desde el panel de la pasarela (Stripe Dashboard, PayPal, o contactando con tu banco en el caso de Redsys). Después, actualiza manualmente el estado del pedido en AOS Palace si corresponde.
El participante vive un proceso de pago claro y sin interrupciones. Desde su punto de vista, elegir pagar con tarjeta o con PayPal es tan sencillo como seleccionar esa opción en el catálogo.
¿Qué ve el participante en el catálogo?
Al llegar al paso de pago en el proceso de inscripción, el participante ve una lista de métodos disponibles. Cada pasarela activa aparece con el nombre que hayas personalizado en los ajustes de AOS Pulse (ej. "Tarjeta de Crédito", "PayPal", "Pago Seguro con Tarjeta").
¿Qué ocurre si el pago falla?
Si el pago es rechazado (tarjeta sin fondos, datos incorrectos, etc.), la pantalla de la pasarela muestra el motivo y el participante puede intentarlo de nuevo o elegir otro método. El pedido queda en estado Pendiente hasta que se complete o cancele.
¿Qué recibe el participante al pagar con éxito?
Al completarse el pago, el participante regresa automáticamente a su perfil en el congreso y recibe el email de confirmación. En la sección Mis Servicios de su perfil puede ver el pedido confirmado, descargar la factura y acceder a los servicios adquiridos (certificados, credenciales de acceso, etc.).
El nombre del sitio (nombre del congreso tal como está configurado en WordPress) aparece automáticamente en la pantalla de pago de PayPal como identificador del comercio. Asegúrate de que el nombre del sitio en Ajustes → General de WordPress refleja el nombre oficial de tu evento.
| Término | Definición |
|---|---|
| Pasarela de pago | Servicio tecnológico que conecta el sitio web del congreso con los sistemas bancarios para procesar los cobros de forma segura. AOS Pulse integra Stripe, PayPal y Redsys. |
| Sandbox | Entorno de pruebas que simula el comportamiento real del sistema de pago sin procesar cobros reales ni usar dinero real. |
| Producción | Entorno real donde se procesan cobros reales a participantes. Solo debe activarse cuando las pruebas en sandbox están superadas. |
| Webhook | Notificación que la pasarela envía automáticamente al servidor del congreso en tiempo real cuando se produce un evento (como la confirmación de un pago). Permite la confirmación automática de pedidos sin que el administrador intervenga. |
| Clave Pública | Clave de identificación de la cuenta que puede compartirse con seguridad. La usa el navegador del participante para iniciar la sesión de pago. |
| Clave Secreta | Clave privada que autoriza las llamadas al servidor de la pasarela. Nunca debe compartirse ni exponerse públicamente. |
| Confirmación automática | Proceso por el que AOS Pulse actualiza el pedido a confirmado, activa los servicios y envía el email de confirmación sin intervención manual del administrador, al recibir la notificación de pago exitoso. |
| FUC | Código de identificación de comercio en el sistema Redsys. Lo facilita el banco al contratar el TPV virtual. Tiene 9 dígitos. |
| TPV Virtual | Terminal Punto de Venta en entorno digital. Equivalente al datáfono físico de una tienda, pero en línea. Redsys es la solución TPV virtual estándar en España. |
| PCI DSS | Estándar de seguridad para la protección de datos de tarjetas. AOS Pulse cumple este estándar porque los datos de tarjeta nunca pasan por el servidor del congreso — solo por los servidores certificados de cada pasarela. |
| Reembolso | Devolución de un cobro a un participante. Se gestiona directamente desde el panel de la pasarela (Stripe, PayPal o Redsys), no desde AOS Pulse. |
Las pasarelas no aparecen en el checkout aunque están configuradas
Verifica que: (1) la licencia de AOS Pulse está activa en AOS Palace → AOS Pulse → Licencia, (2) la pasarela tiene el checkbox Habilitar marcado, y (3) las credenciales están correctamente guardadas. Sin licencia activa, las pasarelas quedan bloqueadas aunque estén configuradas.
El participante paga pero el pedido sigue como "Pendiente"
Esto suele indicar que el webhook no está llegando al servidor. Comprueba que: (1) la URL del webhook está correctamente configurada en el panel de la pasarela, (2) el sitio tiene HTTPS activo (sin SSL los webhooks no funcionan), y (3) no hay ningún plugin de seguridad bloqueando las peticiones externas a la URL del webhook.
¿Puedo tener activas las tres pasarelas al mismo tiempo?
Sí. Puedes tener activas simultáneamente Stripe, PayPal y Redsys. El participante verá las tres como opciones en el checkout, además de la transferencia bancaria si está configurada en AOS Palace Core.
¿AOS Pulse almacena los datos de tarjeta de los participantes?
No. Los datos de tarjeta nunca pasan por el servidor del congreso ni se almacenan en la base de datos de WordPress. Todo el proceso sensible ocurre exclusivamente en los servidores certificados de Stripe, PayPal o Redsys. AOS Pulse solo recibe la confirmación de que el pago fue exitoso.
¿Cómo hago una devolución a un participante?
Accede al panel de la pasarela correspondiente (Stripe Dashboard, panel de PayPal, o el portal de Redsys de tu banco) y realiza el reembolso desde allí. Después actualiza manualmente el estado del pedido en AOS Palace si es necesario. AOS Pulse no tiene actualmente un botón de reembolso directo desde WordPress.
El pago de prueba funciona pero en producción da error
Comprueba que has sustituido todas las claves de prueba por las de producción. Asegúrate también de que el webhook de producción apunta a la URL correcta de tu sitio (con el dominio real, no localhost) y que el sitio tiene HTTPS válido. Para Stripe, recuerda crear un webhook en modo Live aparte del webhook de test.
¿AOS Pulse funciona en instalaciones WordPress Multisite?
Sí, AOS Pulse es compatible con WordPress Multisite. Las tablas de registro de transacciones usan el mismo prefijo compartido que el resto del ecosistema AOS Palace, garantizando la coherencia de datos en instalaciones multi-sitio.