E-commerce
Lemon Squeezy en tu producto y en tus agentes de IA, con una API
El toolkit de Lemon Squeezy lista tiendas, productos, variantes, pedidos, clientes, suscripciones y descuentos, y crea clientes, códigos de descuento y enlaces de checkout. Con Connect, un producto o agente de IA vende y supervisa las ventas en la cuenta del cliente sin construir la integración ni guardar su clave de API.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/lemon_squeezy_create_customer/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"data": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a Lemon Squeezy.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Lemon Squeezy. 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 Lemon Squeezy.
Enlaces de checkout desde tu producto
Crea un checkout para una variante con los datos del comprador rellenados y un código de descuento opcional, y envía el enlace desde tu app o un agente.
Seguimiento de ventas por un agente
Deja que un agente de IA liste pedidos y suscripciones recientes por estado, como past_due o cancelled, y resuma lo que necesita atención.
Códigos promocionales de campaña
Crea un código de descuento para una tienda, limitado a variantes elegidas, cuando se lance una campaña en tu herramienta de marketing.
Tools
12 tools de Lemon Squeezy
- Listar tiendasGETLista las tiendas del usuario por nombre, con dominio, moneda, ventas totales e ingresos en centavos. El id de una tienda va en la relationship store de Create customer, Create discount y Create checkout. Solo vuelven las 10 primeras.
- Listar productosGETLista los productos de todas las tiendas del usuario por nombre, con estado, rango de precios, buy_now_url y store_id. Solo vuelven los 10 primeros; meta.page.total tiene el conteo. List product variants devuelve las variantes que usan los checkouts y descuentos.
- Listar variantes del productoGETLista las variantes de un producto con precio en centavos, intervalo de suscripción, prueba gratuita y estado. El id de una variante va en Create checkout y en las variants de Create discount. Solo vuelven las 10 primeras.
- Listar pedidosGETLista los 10 pedidos más nuevos de todas las tiendas del usuario, con order_number, nombre y correo del comprador, estado, totales en centavos, reembolsos y URL del recibo. Los pedidos más antiguos solo se alcanzan por id en Get order; meta.page.total tiene el conteo.
- Obtener pedidoGETDevuelve un pedido: order_number, comprador, estado, moneda, subtotal, descuento, impuesto, total e importe reembolsado en centavos, el primer artículo del pedido y la URL del recibo.
- Listar clientesGETLista los 10 clientes más nuevos de todas las tiendas del usuario, con nombre, correo, estado de marketing (subscribed, unsubscribed, archived, requires_verification, invalid_email o bounced), MRR e ingresos totales en centavos. meta.page.total tiene el conteo.
- Crear clientePOSTCrea un cliente en una tienda y lo devuelve. Los campos van dentro de data, en JSON:API: type, attributes con name y email, y la tienda en relationships.
- Actualizar clientePATCHModifica un cliente y lo devuelve. Los campos van dentro de data, en JSON:API, con el mismo id que customer_id. Solo cambian los attributes enviados; status archived detiene los correos de marketing.
- Listar suscripcionesGETLista las 10 suscripciones más nuevas de todas las tiendas del usuario, con producto, variante, correo del cliente, estado (on_trial, active, paused, past_due, unpaid, cancelled o expired), renews_at, ends_at y order_id. meta.page.total tiene el conteo.
- Listar descuentosGETLista los códigos de descuento de todas las tiendas del usuario, del más antiguo al más nuevo, con code, amount, amount_type, límite de canjes, fechas y estado. Solo vuelven los 10 primeros; meta.page.total tiene el conteo.
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 Lemon Squeezy
¿Necesito implementar la API de Lemon Squeezy?
No. Connect ya trae 12 tools de Lemon Squeezy 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 Lemon Squeezy?
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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
