Conectar Payora con WooCommerce Subscriptions

Cómo conectar Payora con WooCommerce Subscriptions

WooCommerce Subscriptions es exigente, pero para bien. Mantiene el cobro recurrente en orden, aunque eso también significa que no puedes tratar Payora como un simple complemento de pago único y esperar que la lógica de renovaciones se arregle sola.

Esta guía sirve para una tarea muy concreta: integrar Payora en WooCommerce Subscriptions en una tienda de WooCommerce que ya usa la extensión Subscriptions, sin cambiar el resto de la tienda. Si solo quieres que los nuevos pedidos recurrentes usen Payora, basta con eso. Si quieres rehacer todos los flujos de pago, este no es el artículo adecuado.

Primera advertencia, breve. El trabajo con suscripciones toca el proceso de pago, los avisos de renovación, el comportamiento de los métodos guardados y los registros de pedidos, así que un solo ajuste omitido puede generar renovaciones problemáticas más adelante.

1. Confirma el escenario exacto de WooCommerce Subscriptions

Empieza por la tienda que realmente tienes, no por la que te gustaría tener. Si WooCommerce ya está en funcionamiento y WooCommerce Subscriptions ya está activo, entonces lo normal es añadir Payora para las nuevas suscripciones sin modificar productos, impuestos, envíos ni plantillas de correo existentes.

Suena modesto, porque lo es. El objetivo no es reescribir la gestión de pedidos de toda la tienda, sino hacer que el proceso de compra de suscripciones pase por Payora para los planes compatibles.

Si tu tienda todavía acepta solo pagos únicos, para aquí y cambia primero la estructura de la tienda. Si ya existen suscripciones, sigue adelante.

Para tener más contexto sobre Payora en ecommerce, la guía sobre la pasarela de pagos cripto para ecommerce puede ayudarte a comparar modelos de pago antes de tocar el checkout en producción.

2. Comprueba los requisitos previos del plugin y la cuenta

Necesitas acceso de administrador en WordPress. También necesitas WooCommerce, WooCommerce Subscriptions y una cuenta de comerciante de Payora con las credenciales necesarias para acceso de pruebas o producción.

Revisa la lista de plugins antes de hacer cualquier otra cosa. Ver un panel limpio no garantiza nada, pero sí te dice si las piezas básicas ya están en su sitio.

Abre la cuenta de Payora y confirma los datos del comerciante, las claves API y cualquier valor de callback o webhook que proporcione la cuenta. Si Payora ofrece valores distintos para sandbox y para uso real, anótalos por separado.

No omitas la revisión de la cuenta. Una clave que falte puede hacer que el checkout de una suscripción parezca correcto en la parte visible, mientras falla en silencio la parte recurrente.

También confirma que el rol del propietario de la tienda o del desarrollador pueda editar los ajustes de pago en WooCommerce. Una sola cuenta demasiado restringida basta para frenar toda la configuración.

3. Localiza los ajustes de pago de Payora dentro de WooCommerce

En WordPress, ve a WooCommerce, luego a Ajustes y después a Pagos. Ese suele ser el lugar donde aparecen las pasarelas, aunque la ruta exacta puede variar si Payora está instalado como opción integrada, como extensión aparte o mediante una integración personalizada.

Busca Payora en la lista de métodos de pago. Si aparece con un interruptor de activación y un botón de ajustes, probablemente estás trabajando con una pasarela que puede configurarse directamente dentro de WooCommerce.

Si Payora no aparece en absoluto, comprueba si el plugin está instalado, si la extensión está activa y si la integración requiere un conector independiente. Tres comprobaciones valen más que una suposición.

Presta atención al texto relacionado con suscripciones. Algunas pasarelas admiten el pago normal, pero no las renovaciones recurrentes. Esa diferencia importa más que la etiqueta del botón.

Una nota rápida de administración: si la página de ajustes ofrece un modo de prueba, déjalo activado por ahora. Un solo clic en modo real basta para crear una suscripción auténtica antes de que estés listo.

4. Conecta las credenciales de Payora para el checkout de suscripciones

Introduce el identificador del comerciante de Payora, las claves API y cualquier valor secreto exactamente como se proporcionen. Un solo error tipográfico puede romper la autenticación y, en la facturación de suscripciones, quizá no lo notes hasta el primer intento de renovación.

Si la configuración incluye una URL de callback o un endpoint de webhook, añádelo en ambos sitios: en la cuenta de Payora y en los ajustes de la pasarela de WooCommerce, si la integración pide ambas cosas. El evento de renovación necesita una ruta de regreso a WooCommerce para que el estado de la suscripción cambie cuando el pago se apruebe o falle.

Esta es la parte más técnica, y aun así consiste sobre todo en escribir con cuidado. Copia, pega, comprueba y guarda.

Para tiendas que quieren una referencia técnica más profunda, la guía de integración de la API de pagos cripto de Payora es el complemento adecuado, especialmente si tu configuración no es una pasarela estándar de instalar y usar.

Hay una frase que muchos dueños de tienda buscan y luego complican más de la cuenta: "cómo conectar Payora con WooCommerce Subscriptions". El proceso es más sencillo de lo que parece si tu pasarela ya admite lógica de pedidos recurrentes, porque la tarea principal es asegurarte de que el pago inicial y el callback de renovación apunten a los mismos datos de la cuenta de Payora.

Si vas a configurar pagos recurrentes con Payora en WooCommerce, guarda los ajustes y vuelve a cargar la página para confirmar que permanecen. Un ajuste que desaparece al refrescar no es un ajuste.

5. Configura el comportamiento de pago de las suscripciones

Ahora abre los ajustes de WooCommerce Subscriptions e inspecciona el comportamiento de renovación. Los puntos importantes son los métodos de pago guardados, el comportamiento de reintento de cobro y si los clientes pueden usar Payora tanto para el primer pago como para las renovaciones posteriores.

Algunas tiendas permiten Payora solo en el alta y luego cambian las renovaciones a otro método. Otras dejan que Payora gestione ambas cosas. Las reglas de tu producto determinan qué modelo encaja mejor.

Si tu pasarela guarda las credenciales de pago del cliente de una forma que WooCommerce Subscriptions reconoce, activa la opción de métodos de pago guardados. Si no lo hace, no la fuerces.

El comportamiento de reintento merece una revisión seria. Un fallo en la renovación puede activar correos, cambios de estado o reglas de cancelación, y esas acciones deberían coincidir con tu política de soporte, no con un ajuste predeterminado que nunca leíste.

Fíjate en los métodos de pago mixtos dentro de una misma suscripción. Eso puede pasar si un cliente empieza con una pasarela y más tarde cambia a Payora. Las configuraciones mixtas se pueden gestionar, pero deben ser intencionadas.

Si quieres una forma práctica de valorar la calidad de los pagos después de activarlo, lee cómo medir el éxito de los pagos cripto. Es más fácil corregir pronto los patrones de renovación defectuosos que después de un mes de tickets de soporte.

6. Prueba un alta de suscripción y la primera renovación

Primero prueba un producto de suscripción. Uno basta. Elige una página de producto, haz un pedido de suscripción y sigue el recorrido desde el carrito hasta la confirmación.

Usa una cuenta de cliente de prueba si es posible. Luego comprueba si WooCommerce crea el registro de suscripción, el pedido principal y el estado inicial correcto.

La primera prueba de renovación importa más que el primer checkout. Un pago puede completarse aunque la lógica de renovación falle en silencio más adelante.

Dispara el evento de renovación en tu entorno de pruebas o sigue el calendario de renovación que hayas configurado. Después confirma que WooCommerce actualiza el estado de la suscripción cuando Payora devuelve el resultado del pago.

Si quieres una lista previa para esta fase, el artículo sobre cómo probar un pago cripto resulta útil porque aquí aplican las mismas costumbres: prueba el pago y luego prueba el resultado que produce.

Anota el resultado exacto de la prueba. ¿El pedido pasó a activo, pendiente o en espera? ¿Se envió el correo de renovación? ¿El registro del pedido en el panel mostró la nota esperada?

Nota breve de prueba: no te saltes la renovación. Nunca.

7. Verifica los mensajes para el cliente y la gestión de pedidos en el administrador

Los clientes deben ver el mensaje de pago correcto en el checkout, y el texto debe reflejar lo que Payora hace realmente. Si la pasarela requiere una redirección, dilo. Si la confirmación del pago llega más tarde, no se debe indicar al cliente que el pedido está completado demasiado pronto.

Revisa el correo de confirmación de la suscripción. Después revisa el correo de renovación. Y luego el correo de cancelación, si tu tienda envía uno. Tres correos, tres lugares donde puede haber un lenguaje incoherente.

En el panel de administración, abre el registro de la suscripción y el pedido asociado. Deberías ver el nombre de la pasarela, el estado del pago y cualquier nota que identifique el intento de renovación o el resultado del callback.

Si el equipo de soporte gestiona reembolsos o revisiones manuales, necesita ver los mismos datos. Un registro administrativo limpio ahorra tiempo durante los primeros diez casos de soporte, y probablemente también después.

Una referencia interna útil es cómo migrar desde crypto manual, porque algunas tiendas están pasando de pagos procesados a mano a facturación por suscripción y necesitan mantener coherentes los registros internos.

No dejes el texto del mensaje demasiado vago. "Pago recibido" solo está bien si la renovación está realmente completada. Si todavía hay una confirmación de red pendiente, di eso en su lugar.

8. Gestiona los casos límite de suscriptores existentes

Los suscriptores actuales son la parte delicada. Si ya pagan con otro método, decide si quieres que se queden con ese método o que pasen a Payora solo cuando renueven manualmente o se vuelvan a suscribir.

En muchas tiendas, la regla más limpia es sencilla: las nuevas suscripciones usan Payora y los suscriptores existentes conservan su método actual hasta que ocurra un cambio natural. Así evitas obligar a actuar a clientes a los que nunca se les pidió cambiar.

Si sí quieres migrar a los suscriptores actuales, comprueba si WooCommerce Subscriptions permite cambiar el método sin crear una suscripción nueva. Si no lo permite, planifica una vía de re-suscripción y explícaselo claramente a los clientes.

Esa explicación importa. La gente acepta un método de facturación nuevo si entiende el motivo. Lo que más odian son las sorpresas.

Los administradores de la tienda también deben decidir qué ocurre con los pedidos antiguos de renovación. Déjalos legibles. Mantén intacto el historial. No borres pruebas solo porque haya cambiado la pasarela.

Una pregunta práctica aparece a menudo: ¿qué pasa si el cliente quiere cambiar solo la próxima renovación a Payora? En ese caso, prueba primero el flujo de actualización en staging, porque el objeto de suscripción y el registro del método de pago pueden no cambiar en el mismo paso.

Otra pregunta relacionada es si Payora debe aparecer para todos los productos o solo para los productos de suscripción. Si tu tienda vende tanto productos físicos como servicios recurrentes, separa ahora esas reglas y no más tarde.

Mantén esta lista cerca durante el despliegue. Es pequeña a propósito.

Si más adelante necesitas ajustar la estructura de la integración, el siguiente paso adecuado es el artículo sobre la pasarela de pagos cripto para freelancers solo si tu modelo de suscripción también se parece a la facturación y emisión de facturas a clientes, porque ahí es donde suelen coincidir las expectativas sobre pagos recurrentes.

Una última nota de campo: si Payora y WooCommerce no coinciden en el tiempo, confía primero en los registros y luego en la pantalla. Las pantallas pueden ir con retraso. Los registros cuentan la historia.