Finanzas y pagos
Stripe en tu producto y en tus agentes de IA, con una API
El toolkit de Stripe cubre clientes, cobros, suscripciones y facturas, con búsqueda, creación de clientes y de facturas en borrador y actualización de suscripciones. Tu cliente conecta una vez con una API key, y tu producto o agente de IA llama cada operación a través de Connect, que guarda la credencial y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/stripe_create_customer/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Stripe.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Stripe. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Stripe.
Vistas de facturación en tu producto
Busca suscripciones, facturas y cobros de un cliente por estado o fecha para mostrar el historial de facturación dentro de tu SaaS o panel de agencia.
Facturar desde tu flujo
Crea un cliente, una factura en borrador y sus líneas, y finalízala y envíala por email con Send invoice cuando termine un trabajo o proyecto.
Preguntas de ingresos para un agente
Deja que un agente de IA busque suscripciones nuevas o canceladas en un periodo, o fije cancel_at_period_end en una suscripción, dentro de un flujo de retención.
Tools
12 tools de Stripe
- Buscar clientesGETBusca clientes con el lenguaje de consulta de búsqueda de Stripe, por email, nombre, teléfono, fecha de creación o metadata. La respuesta trae data, has_more y next_page; envía next_page como page para la página siguiente. Un cliente creado o actualizado en el último minuto puede no aparecer todavía.
- Obtener clienteGETDevuelve un cliente, con nombre, email, teléfono, dirección, saldo en centavos y ajustes de factura. Un cliente eliminado vuelve solo con id y deleted true.
- Crear clientePOSTCrea un cliente. Ningún campo es obligatorio, pero Stripe solo envía facturas y recibos a clientes con email. Dirección, tax ids y metadata no están disponibles aquí.
- Actualizar clientePOSTActualiza el nombre, el email, el teléfono o la descripción de un cliente. Los campos no enviados se quedan como están.
- Buscar cobrosGETBusca los cobros, que son los intentos de pago con estado, importe, reembolsos y disputas, con el lenguaje de consulta de búsqueda de Stripe. Los importes están en la unidad más pequeña de la moneda, como centavos. La respuesta trae data, has_more y next_page; envía next_page como page para la página siguiente.
- Listar suscripcionesGETLista las suscripciones, de la más nueva a la más antigua, opcionalmente de un cliente, un precio o un estado. Sin status, las suscripciones canceladas quedan fuera. Cada suscripción trae sus precios en items.data. Pagina con starting_after mientras has_more sea true.
- Buscar suscripcionesGETBusca suscripciones por estado, fecha de creación, fecha de cancelación o metadata con el lenguaje de consulta de búsqueda de Stripe, lo que sirve para preguntas como suscripciones nuevas o canceladas en un periodo. La respuesta trae data, has_more y next_page; envía next_page como page para la página siguiente.
- Actualizar suscripciónPOSTActualiza una suscripción, por ejemplo para cancelarla al final del periodo actual con cancel_at_period_end, o para deshacerlo. Cambiar los elementos o precios de la suscripción no está disponible aquí.
- Buscar facturasGETBusca facturas por cliente, suscripción, estado, fecha, total o número con el lenguaje de consulta de búsqueda de Stripe. Los importes están en la unidad más pequeña de la moneda, como centavos. La respuesta trae data, has_more y next_page; envía next_page como page para la página siguiente.
- Crear facturaPOSTCrea una factura en borrador para un cliente. Añade las líneas con Create invoice item y envíala por email con Send invoice. Con collection_method send_invoice, envía days_until_due o due_date.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Stripe
¿Necesito implementar la API de Stripe?
No. Connect ya trae 12 tools de Stripe descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Stripe?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.

Conta Azul