Documentación de Rivya AI

Guía de pagos y compras en Rivya

Descubre cómo funcionan la compra de planes y paquetes de créditos en Rivya, las redirecciones de Stripe, la página /payment, los webhooks, las actualizaciones de facturación y la comprobación de cada compra.

Última revisión el 2026/04/28

Usa esta guía cuando necesites saber qué ocurre después de comprar un plan o un paquete de créditos en Rivya.

Lo que la gente suele malinterpretar sobre el pago en Rivya es esto:

Que Stripe complete el pago no es el último paso. El producto todavía tiene que ponerse al día y reflejar correctamente ese cambio.

Por eso el proceso de compra no termina en Stripe ni en el momento en que el navegador regresa a Rivya.

El flujo de pago tiene tres etapas reales

El proceso se entiende mejor si se divide en tres etapas:

  1. Rivya crea la sesión de Stripe Checkout

  2. el usuario completa Stripe Checkout

  3. Rivya espera a que el estado del producto vuelva a ser confiable

Esa tercera etapa es exactamente la razón por la que existe /payment.

Dónde puede empezar una compra

La compra puede empezar en distintas páginas, según lo que quiera hacer el usuario:

  • Precios

  • /settings/billing

  • /settings/credits

Y las dos formas principales de compra son:

  • compra de un plan de suscripción

  • compra única de un paquete de créditos

Son decisiones comerciales distintas, pero convergen en la misma ruta de confirmación.

Comprar un plan y comprar créditos son procesos parecidos, pero no iguales

La compra de un plan crea una suscripción.

La compra de un paquete añade créditos al saldo de la cuenta una sola vez.

Esa diferencia importa porque, después del pago, Rivya necesita saber qué debe actualizar:

  • el estado de la suscripción

  • o el saldo de créditos

Por eso el mismo evento de éxito en Stripe puede devolverte después a distintas áreas del producto.

Por qué existe /payment

/payment no es una página de recibo en el sentido habitual.

Es un puente de procesamiento.

Su trabajo es:

  • leer el session_id de Stripe

  • comprobar si el registro de pago del lado del producto ya se asentó

  • seguir consultando durante un periodo corto si es necesario

  • solo entonces redirigirte al área correcta de la aplicación

Eso la hace más parecida a una página de sincronización de estado que a una página de contenido.

Cuándo está "realmente hecho" un pago desde la perspectiva del producto

Desde el punto de vista del usuario, el pago parece completo cuando Stripe dice que funcionó.

Desde el punto de vista del producto, el pago solo está realmente completo cuando el estado de la cuenta se ve actualizado en Rivya.

Eso normalmente significa:

  • el registro de pago aparece como paid o completed

  • la suscripción o el saldo de créditos ya reflejan la compra

  • puedes volver a facturación o créditos sin ver datos obsoletos

Por eso Rivya espera en /payment en lugar de devolver inmediatamente al usuario a la aplicación.

Por qué los webhooks siguen siendo importantes aunque /payment consulte el estado

/payment no reemplaza los webhooks de Stripe.

Los webhooks siguen siendo los responsables de actualizar el estado persistente en el servidor.

La página /payment existe para que la experiencia pueda esperar hasta que ese estado esté reflejado lo suficiente como para confiar en él antes de redirigir.

Esa es la diferencia entre:

  • "Stripe procesó algo"

  • y "Rivya ahora refleja claramente ese cambio"

A dónde vas después del pago

La ruta de regreso depende de lo que haya cambiado.

Si la compra estaba relacionada con una suscripción, normalmente volverás a la página de facturación.

Si compraste un paquete de créditos, normalmente volverás a la página de créditos.

No es una ruta cosmética. Coincide con la pregunta que los usuarios suelen tener justo después de pagar:

  • ¿se actualizó mi plan?

  • ¿se actualizó mi saldo de créditos?

Qué significa realmente agotar el tiempo de espera o encontrar un error

Si /payment agota el tiempo de espera o falla, eso no significa automáticamente que el pago se haya perdido.

Más a menudo significa una de estas cosas:

  • el registro de pago del lado del producto aún no se asentó

  • la redirección está esperando un estado que todavía se está poniendo al día

  • la página de cuenta aún se vería obsoleta si se redirigiera al usuario demasiado pronto

Por eso mostrar que se ha agotado el tiempo de espera es mejor que confirmar el éxito antes de tiempo. Indica al usuario que Rivya todavía no ha terminado de verificar la compra.

La mejor forma de comprobar si el pago llegó realmente

Después de la compra, la forma más clara de comprobar el resultado es:

  1. deja que /payment termine el proceso

  2. revisa /settings/billing si la compra fue un plan

  3. revisa /settings/credits si la compra fue un paquete de créditos

  4. revisa Centro de notificaciones si la cuenta todavía parece desincronizada

Esto suele ser mejor que actualizar páginas al azar y tratar de adivinar qué ha ocurrido.

El pago también se convierte en memoria de cuenta

El pago no es solo una acción de compra. También pasa a formar parte del historial de la cuenta mediante eventos persistentes como:

  • suscripción iniciada

  • suscripción renovada

  • pago fallido

  • paquete de créditos añadido

Por eso las notificaciones también importan aquí. Cerrar la pestaña de Stripe no es el final de la historia de la cuenta.

Una forma más clara de entenderlo

La forma más sencilla de entender el proceso de compra de Rivya es:

  • Stripe maneja el movimiento de dinero

  • /payment gestiona el regreso y la sincronización dentro de Rivya

Si separas esas dos funciones, todo el proceso resulta más fácil de entender.

Leer a continuación

Lista de comprobación del estado de la compra

Cuando una compra parezca incompleta o confusa, comprueba:

  • Confirma dónde empezó la compra: la página pública de precios, la configuración de facturación o la configuración de créditos.

  • Comprueba si Stripe completó el pago y devolvió al usuario a /payment.

  • Espera a que Rivya actualice la suscripción, el paquete, la factura y el saldo de créditos antes de iniciar otra tarea de pago.

  • Usa las páginas de facturación para las suscripciones y las de créditos para los paquetes o el historial del saldo.

  • No consideres una redirección del navegador como prueba de que el webhook y el estado de la cuenta ya se han procesado.

Revisa antes de reintentar el pago

Revisa el estado antes de reintentar el pago si el usuario ve un plan obsoleto, créditos que faltan, ventanas duplicadas de Stripe Checkout, un pago fallido o un recibo correcto de Stripe que todavía no se refleja en Rivya.