> ## Documentation Index
> Fetch the complete documentation index at: https://docs.min-ai.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe

> Tu agente sigue tus clientes, suscripciones y cobros de Stripe, te avisa de lo que importa y reembolsa o cancela solo si lo permitís y con tu OK.

<img src="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/plugins/stripe.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=67a7c1339184de43a2b0dfe8090b4e29" alt="" width="56" height="56" noZoom style={{ borderRadius: '14px' }} data-path="images/plugins/stripe.png" />

Con Stripe, tu agente te cuenta cómo viene tu negocio: cuántos trials se convirtieron, quién canceló, qué pagos fallaron y cuánto cobraste. Te avisa en el momento de lo que importa y, si querés, te manda un resumen cada semana. Reembolsar o cancelar, solo si prendés el permiso y con tu OK.

| | |
| - | - |
| **Categoría** | Finanzas |
| **Para** | Agentes personales y de grupo (por ejemplo, el agente de tu equipo) |
| **Qué te pide** | Una clave restringida de Stripe y, si querés avisos en el momento, un webhook |
| **Cómo se conecta** | Con links de un solo uso que te manda tu agente |

## Qué puede hacer

<CardGroup cols={2}>
  <Card title="Consultar" icon="magnifying-glass">
    Un cliente y sus suscripciones (con trials) y facturas; buscar clientes; suscripciones, facturas, cobros (también los fallidos), reembolsos, precios y tu saldo. Y un **resumen del período**: altas, trials convertidos, vencidos o cancelados, bajas pagas, lo cobrado y los reembolsos.
  </Card>

  <Card title="Cambiar, con tu OK" icon="rotate-left">
    Reembolsar un cobro (todo o una parte) y cancelar una suscripción (al final del período o ya). Necesita el permiso prendido.
  </Card>
</CardGroup>

### Avisos en el momento

Con el webhook configurado, tu agente te avisa solo lo que vale la pena, en una línea (quién, qué plan, cuánto). Por defecto: un trial que pasa a pago, una suscripción paga nueva, un pago que falla y una disputa. También puede avisarte de cancelaciones pagas y reembolsos: decíselo en el chat.

### Resumen semanal

Stripe trae una programación para mandarte un resumen. Viene apagada: la acordás con tu agente (por ejemplo, «los lunes a las 9») y él la configura.

## Cómo se conecta

<Steps>
  <Step title="Agregalo a un agente">
    Desde **Plugins → Stripe → Agregar a un agente**, o pedíselo a tu agente en el chat. Ver [Agregar un plugin](/es/herramientas/agregar-un-plugin).
  </Step>

  <Step title="Creá una clave restringida">
    Una clave restringida solo puede lo que vos marcás. Abrí [dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys) → **Crear clave restringida** y ponele de nombre **minai**. Marcá **Lectura** en Customers, Subscriptions, Invoices, Charges, Refunds, Prices, Products y Balance; lo demás, sin acceso. Si querés que pueda reembolsar y cancelar, marcá **Escritura** en Refunds y Subscriptions. Creala y copiala: empieza con **rk\_live\_**.
  </Step>

  <Step title="Pegala en el link de tu agente">
    Tu agente te manda un link de un solo uso para la clave. Pegala ahí, no en el chat. Ver [Claves y datos](/es/herramientas/claves-y-datos).
  </Step>

  <Step title="Avisos en el momento (opcional)">
    Tu agente te pasa la dirección de su webhook. En [dashboard.stripe.com/webhooks](https://dashboard.stripe.com/webhooks) tocá **Agregar destino**, elegí estos eventos: customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment\_failed, charge.dispute.created y charge.refunded; y como destino, esa dirección. Copiá el **Secreto de firma** (empieza con **whsec\_**) y pegalo en el link que te manda tu agente.
  </Step>

  <Step title="Tu agente confirma">
    Prueba que todo ande y te cuenta en el chat qué puede hacer.
  </Step>
</Steps>

<Tip>
  Para cortarle el acceso, borrá la clave en Stripe.
</Tip>

## El permiso

En la tarjeta de Stripe, en la pestaña **Plugins** del agente, está el interruptor **Permitir cambios**: «Reembolsar cobros y cancelar suscripciones, siempre con tu OK. Apagado, solo consulta.»

Arranca apagado y solo lo cambiás vos. El límite lo ponen los servidores de minai: tu agente no lo puede saltear. Ver [Permisos](/es/herramientas/permisos).

<Warning>
  Un reembolso vuelve a la tarjeta del cliente y no se puede deshacer. Cancelar una suscripción le corta el servicio. Revisá cada vista previa antes de confirmar.
</Warning>

## Cómo te cuida

* **Nada cambia sin tu OK.** Antes de reembolsar o cancelar te muestra qué cobro o suscripción y cuánto, con los botones **Confirmar** y **Cambiar**. Solo con tu sí se hace, y ese OK vale para esa operación exacta.
* Si un cambio falla, se fija qué pasó antes de reintentar.
* Nunca les escribe a tus clientes por su cuenta.
* Tu agente nunca ve tu clave: la agregan los servidores de minai en cada consulta.
* Los datos de tus clientes: solo lo necesario para lo que preguntaste.

## Ejemplos para pedirle

* «¿Cuántos trials se convirtieron esta semana?»
* «Pasame el resumen de septiembre: altas, bajas y lo cobrado.»
* «¿Qué pasa con el cliente [maria@empresa.com](mailto:maria@empresa.com)? ¿Está al día?»
* «¿Qué pagos fallaron en los últimos 7 días?»
* «Reembolsale el último cobro a [juan@x.com](mailto:juan@x.com).»
* «Mandame el resumen todos los lunes a las 9.»

## Límites

* Si la clave no tiene lectura sobre algo, tu agente te dice «permiso denegado»: agregale **Lectura** en Stripe.
* Los avisos en el momento llegan recién cuando cargaste el secreto del webhook.
* Los horarios de Stripe los pasa a tu zona horaria.

## Si lo quitás

Tu agente pierde el acceso en menos de un minuto y te lo confirma. La clave y el secreto se borran de minai con el plugin; para cerrar del todo, borrá también la clave (y el webhook) en Stripe. Ver [Quitar un plugin](/es/herramientas/quitar-un-plugin).

<CardGroup cols={2}>
  <Card title="Mercado Pago" icon="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/plugins/mercadopago.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=96c820f26407f53199f6c9b1aa8a3f45" href="/es/plugins/mercado-pago" width="128" height="128" data-path="images/plugins/mercadopago.png">
    Tu cuenta de Mercado Pago, con tu OK para mover plata.
  </Card>

  <Card title="Permisos" icon="shield-halved" href="/es/herramientas/permisos">
    Los interruptores de cada plugin y qué destraban.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.