Pagos
Video coming soon
El vídeo de pagos está en camino. Mientras tanto, esta lección cubre la forma en producción de cobrar en HeroMate hoy.
Integra pagos para que tu aplicación pueda cobrar a tus clientes. La vía actual usa el nodo de workflow genérico Stripe con tus propias claves de Stripe (BYOK), de modo que toda la lógica de cobro corre en el servidor y tus secretos no llegan al frontend.
La vía en producción: nodo Stripe + credenciales BYOK
Añade tus credenciales de Stripe
En tu proyecto, ve a Studio → Ajustes → Configuración avanzada → Credenciales manuales de servicios y crea una credencial Stripe con tu clave secreta de Stripe. Para verificar los eventos entrantes, añade también una credencial Stripe Webhook con tu secreto de firma del webhook. Se guardan cifradas (Fernet, por proyecto) y se descifran solo en el momento de ejecución — nunca se exponen al navegador.
Construye un endpoint de pago
En Build → API, crea un endpoint y añade el nodo Stripe a su workflow (por ejemplo, para crear una Checkout Session o un PaymentIntent). El nodo usa la credencial Stripe que añadiste; corre en el servidor, así que la clave secreta nunca llega al cliente.
Gestiona el webhook
Crea un segundo endpoint con un trigger de Webhook para que Stripe te avise cuando un pago se complete. Verifica la firma del evento con la credencial Stripe Webhook y luego actualiza tu base de datos (marca el pedido como pagado, desbloquea una función, etc.).
Prueba antes de salir a producción
Usa las claves de modo test de Stripe y una tarjeta de prueba para recorrer el flujo completo de punta a punta antes de cambiar a las claves reales.
Mantén los secretos en el servidor
Nunca pongas tu clave secreta de Stripe en una variable de Frontend (Build) — esas quedan dentro del bundle del cliente. La lógica de cobro va en un endpoint usando la credencial Stripe. Para otros secretos de ejecución, usa Backend Secrets (Ship → Frontend → Variables), referenciados como ctx.secrets.X.
HeroMate Payments
Cuando esté habilitado para tu entorno, abre Studio → Pagos. Selecciona Pruebas, el país del negocio y Conectar Stripe. Un administrador de la organización con un plan de pago puede completar la verificación y gestionar cobros y transferencias dentro de HeroMate.
La pestaña Resumen muestra ingresos netos, suscripciones activas y una gráfica de los últimos 7, 30 o 90 días. Los ingresos netos proceden de los movimientos de Stripe, con sus comisiones y ajustes reales; no equivalen al saldo disponible para transferir. Cada moneda se muestra por separado y las fechas usan UTC.
En Transacciones consulta cobros o suscripciones. En Ajustes consulta reembolsos, disputas y notas de crédito. Las listas incluyen paginación. Cuenta de Stripe abre la configuración y la gestión integrada de cobros, reembolsos y transferencias.
Los pasos de preparación comprueban la cuenta, la existencia de productos y un Checkout pagado confirmado. Crear la oferta, probar una compra y Portal del cliente → Añadir a mi app preparan una petición en el asistente: revisa y envía el borrador para implementar el cambio. El portal del comprador debe abrirse en otra pestaña y vincularse al usuario autenticado desde el servidor.
En el nodo Stripe selecciona HeroMate Connect y el entorno. Puedes crear clientes, productos, precios y sesiones de Checkout para pagos únicos o suscripciones sin introducir claves de Stripe. Las operaciones que modifican datos necesitan una clave de idempotencia estable, por ejemplo el identificador de tu pedido. Los precios deben pertenecer a la cuenta conectada de ese entorno.
Para recibir eventos en un Flow publicado, usa .webhook({ provider: "stripe", event: "invoice.paid", verify: { mode: "stripe", credential: "dypai-stripe-connect-test" } }). La credencial se crea al conectar la cuenta. Usa dypai-stripe-connect-live para producción. Prueba el pago completo y actualiza tu pedido solo después de confirmar el cobro mediante el evento adecuado.
Las cuentas de pruebas y producción son independientes. Los previews no permiten operaciones gestionadas en modo real. La tarjeta muestra el estado de los cobros, transferencias y eventos fallidos, con opciones para verificar la conexión y reintentar. Las claves propias siguen disponibles para las demás operaciones del nodo Stripe.
Qué aprenderás
- Añadir credenciales Stripe y Stripe Webhook en Credentials
- Cobrar desde un endpoint en servidor con el nodo Stripe
- Verificar webhooks y mantener los secretos fuera del frontend
- Probar en modo test de Stripe antes de salir a producción
Listo
Has terminado el bloque Creando nuestra primera app. Vuelve a la visión general de tutoriales o explora el resto de la documentación.