Conecta tu cuenta de Stripe a Goodweek para gestionar pagos, clientes, suscripciones, facturas y datos de facturación directamente desde tu espacio de trabajo de IA.
ℹ️ Nota sobre la gobernanza
Goodweek nunca superará los niveles de acceso concedidos al usuario dentro de Stripe, garantizando la alineación con las políticas de gobernanza de tu organización. Los resultados y las funciones disponibles pueden variar según los permisos específicos y el acceso autenticado de cada usuario.
📋 Requisitos previos
Antes de que cualquier usuario pueda ver y conectar la integración de Stripe, el administrador de tu organización debe habilitarla primero desde el Panel de administración de Goodweek, en la pestaña Integraciones.
Configuración del administrador
La integración de Stripe utiliza OAuth 2.0 y no requiere ninguna aprobación a nivel de administrador dentro de Stripe antes de que los usuarios puedan conectarse.
⚠️ Importante: Modo en vivo frente a modo de prueba
Stripe funciona en dos modos: en vivo y de prueba. Al conectarte, asegúrate de estar autorizando desde el modo correcto para el uso que pretendes darle. Las acciones realizadas a través de Goodweek afectarán al entorno en vivo de Stripe, a menos que estés conectando una cuenta de prueba.
Conexión del usuario
En Goodweek, ve a Integraciones.
Busca Stripe y haz clic en Conectar.
Serás redirigido a Stripe, donde se te pedirá que inicies sesión y autorices el acceso.
Haz clic en Conectar para conceder acceso y volver a Goodweek.
Notas importantes
Cada usuario debe conectar su propia cuenta de Stripe individualmente.
Goodweek funcionará en el modo (en vivo o de prueba) de la cuenta que autorices.
Puedes revocar el acceso de Goodweek en cualquier momento desde el Panel de Stripe → Configuración → Aplicaciones conectadas → Composio → Desconectar.
Herramientas disponibles
Herramienta | Descripción | Tipo |
Crear cliente | Crea un nuevo cliente en Stripe, necesario para crear cargos o suscripciones. | Escritura |
Recuperar cuenta | Recupera información detallada de la cuenta de Stripe autenticada. | Lectura |
Crear intención de pago | Crea un PaymentIntent de Stripe para iniciar y procesar el pago de un cliente. | Escritura |
Confirmar intención de pago | Confirma un PaymentIntent para finalizar el pago con el método de pago proporcionado. | Lectura |
Capturar intención de pago | Captura fondos de un PaymentIntent autorizado cuando está en estado requires_capture. | Lectura |
Recuperar factura | Recupera una factura específica por su ID. | Lectura |
Crear factura | Crea una nueva factura de Stripe en borrador para un cliente. | Escritura |
Crear elemento de factura | Añade una línea a una factura en borrador antes de su finalización. | Escritura |
Añadir líneas a la factura | Añade varias líneas a una factura de Stripe en borrador existente en una sola llamada. | Escritura |
Finalizar factura | Finaliza una factura en borrador, dejándola abierta y lista para su cobro. | Lectura |
Obtener líneas de factura | Recupera una lista paginada de las líneas de una factura específica. | Lectura |
Crear nota de crédito | Emite una nota de crédito para ajustar el importe de una factura finalizada. | Escritura |
Previsualizar nota de crédito | Previsualiza una nota de crédito sin crearla en Stripe. | Lectura |
Crear suscripción de cliente | Crea una nueva suscripción para un cliente existente de Stripe con elementos y precios. | Escritura |
Crear suscripción | Crea una suscripción altamente configurable compatible con varios elementos, periodos de prueba y descuentos. | Escritura |
Recuperar suscripción de cliente | Recupera una suscripción específica de un cliente. | Lectura |
Crear elemento de suscripción | Añade un nuevo elemento a una suscripción existente sin modificar los elementos actuales. | Escritura |
Crear reembolso | Crea un reembolso total o parcial en Stripe dirigido a un cargo o una intención de pago. | Escritura |
Crear reembolso de cargo | Crea un reembolso para un cargo creado previamente. | Escritura |
Crear cupón | Crea un nuevo cupón de descuento con descuento porcentual o de importe fijo. | Escritura |
Crear código de promoción | Crea un código de promoción canjeable por el cliente vinculado a un cupón subyacente. | Escritura |
Crear producto | Crea un nuevo producto en Stripe para representar un bien o servicio. | Escritura |
Crear un precio | Crea un nuevo precio de Stripe para un producto, definiendo sus cargos (único o recurrente). | Escritura |
Crear sesión de pago | Crea una sesión de pago de Stripe para una página de pago o suscripción alojada. | Escritura |
Crear enlace de pago | Crea una URL de pago alojada y compartible que puede enviarse directamente a los clientes. | Escritura |
Crear intención de configuración | Crea un SetupIntent para recopilar permisos de método de pago para uso futuro. | Escritura |
Listar eventos | Recupera una lista de eventos de Stripe de los últimos 30 días con filtrado y paginación. | Lectura |
Recuperar evento | Recupera los detalles de un evento de webhook de Stripe específico por su ID. | Lectura |
Crear una ejecución de informe | Crea e inicia la ejecución asíncrona de un informe financiero de Stripe. | Escritura |
Listar medidores de facturación | Recupera una lista de medidores de facturación configurados para la facturación basada en el uso. | Lectura |
Crear medidor de facturación | Crea un medidor de facturación para el seguimiento de eventos de uso en precios por consumo. | Escritura |
Crear sesión del portal de facturación | Crea una URL de sesión del portal de facturación para que los clientes gestionen sus suscripciones y facturas. | Escritura |
Crear cálculo de impuestos | Calcula los impuestos de una compra de cliente antes de crear un pedido. | Escritura |
Crear transferencia | Crea una transferencia para mover fondos entre cuentas de Stripe como parte de Connect. | Escritura |
Cancelar intención de pago | Cancela un PaymentIntent que ya no es necesario. | ⚠️ Destructiva |
Cancelar suscripción | Cancela la suscripción activa de un cliente en Stripe. | ⚠️ Destructiva |
Eliminar cliente | Elimina permanentemente un cliente y cancela sus suscripciones activas. | ⚠️ Destructiva |
Eliminar factura en borrador | Elimina permanentemente una factura en borrador. Esta acción no se puede deshacer. | ⚠️ Destructiva |
Anular factura | Marca permanentemente una factura finalizada como anulada, impidiendo su cobro. | ⚠️ Destructiva |
Eliminar producto | Elimina un producto de Stripe. Solo es posible si no tiene precios asociados. | ⚠️ Destructiva |
Casos de uso
Crea facturas y cobra pagos desde las conversaciones. Redacta facturas de Stripe, añade líneas, finalízalas y crea enlaces de pago directamente desde Goodweek, útil para facturar a clientes bajo demanda sin navegar por el panel de Stripe.
Gestiona suscripciones y clientes. Crea nuevas suscripciones, añade productos a las existentes y recupera los detalles de suscripción de clientes específicos desde Goodweek para gestionar cambios de facturación rápidamente.
Emite reembolsos y notas de crédito. Crea reembolsos para cargos o intenciones de pago y emite notas de crédito contra facturas finalizadas desde Goodweek al gestionar disputas de clientes o correcciones de facturación.
Supervisa eventos y actividad de facturación. Recupera los eventos recientes de Stripe y fíltralos por tipo desde Goodweek para investigar problemas de pago, cambios de suscripción o actividad de webhooks sin usar el panel de Stripe.
Solución de problemas
Las acciones están afectando al entorno de Stripe incorrecto
Verifica que has autorizado a Goodweek con la cuenta de Stripe correcta (en vivo o de prueba). Desconecta y vuelve a conectar si es necesario, asegurándote de seleccionar la cuenta correcta durante el flujo de autorización de Stripe.
La integración no es visible en Goodweek
Asegúrate de que el administrador de tu organización haya habilitado la integración de Stripe desde el Panel de administración de Goodweek, en la pestaña Integraciones.