E-commerce
Lemon Squeezy dans votre produit et vos agents IA, via une API
Le toolkit Lemon Squeezy liste les boutiques, produits, variantes, commandes, clients, abonnements et remises, et crée des clients, des codes de remise et des liens de checkout. Avec Connect, un produit ou un agent IA vend et suit les ventes dans le compte du client sans construire l'intégration ni stocker sa clé d'API.
15 jours d'essai. Sans carte bancaire.
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": {}
}
}Fonctionnement
Du client connecté au premier appel à Lemon Squeezy.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Lemon Squeezy. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Lemon Squeezy.
Liens de checkout depuis votre produit
Créez un checkout pour une variante avec les données de l'acheteur préremplies et un code de remise optionnel, puis envoyez le lien depuis votre app ou un agent.
Suivi des ventes par un agent
Laissez un agent IA lister les commandes et abonnements récents par statut, comme past_due ou cancelled, et résumer ce qui demande de l'attention.
Codes promo de campagne
Créez un code de remise pour une boutique, limité à certaines variantes, quand une campagne démarre dans votre outil marketing.
Tools
12 tools Lemon Squeezy
- Lister les boutiquesGETListe les boutiques de l'utilisateur par nom, avec domaine, devise, ventes totales et revenus en centimes. L'id d'une boutique va dans la relationship store de Create customer, Create discount et Create checkout. Seules les 10 premières reviennent.
- Lister les produitsGETListe les produits de toutes les boutiques de l'utilisateur par nom, avec statut, fourchette de prix, buy_now_url et store_id. Seuls les 10 premiers reviennent ; meta.page.total contient le nombre total. List product variants renvoie les variantes qu'utilisent les checkouts et remises.
- Lister les variantes du produitGETListe les variantes d'un produit avec prix en centimes, intervalle d'abonnement, essai gratuit et statut. L'id d'une variante va dans Create checkout et dans les variants de Create discount. Seules les 10 premières reviennent.
- Lister les commandesGETListe les 10 commandes les plus récentes de toutes les boutiques de l'utilisateur, avec order_number, nom et e-mail de l'acheteur, statut, totaux en centimes, remboursements et URL du reçu. Les commandes plus anciennes ne sont accessibles que par id dans Get order ; meta.page.total contient le nombre total.
- Obtenir une commandeGETRenvoie une commande : order_number, acheteur, statut, devise, sous-total, remise, taxe, total et montant remboursé en centimes, le premier article de la commande et l'URL du reçu.
- Lister les clientsGETListe les 10 clients les plus récents de toutes les boutiques de l'utilisateur, avec nom, e-mail, statut marketing (subscribed, unsubscribed, archived, requires_verification, invalid_email ou bounced), MRR et revenu total en centimes. meta.page.total contient le nombre total.
- Créer un clientPOSTCrée un client dans une boutique et le renvoie. Les champs vont dans data, en JSON:API : type, attributes avec name et email, et la boutique dans relationships.
- Mettre à jour un clientPATCHModifie un client et le renvoie. Les champs vont dans data, en JSON:API, avec le même id que customer_id. Seuls les attributes envoyés changent ; status archived arrête les e-mails marketing.
- Lister les abonnementsGETListe les 10 abonnements les plus récents de toutes les boutiques de l'utilisateur, avec produit, variante, e-mail du client, statut (on_trial, active, paused, past_due, unpaid, cancelled ou expired), renews_at, ends_at et order_id. meta.page.total contient le nombre total.
- Lister les remisesGETListe les codes de remise de toutes les boutiques de l'utilisateur, du plus ancien au plus récent, avec code, amount, amount_type, limite d'utilisations, dates et statut. Seuls les 10 premiers reviennent ; meta.page.total contient le nombre total.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit Lemon Squeezy
Dois-je intégrer l'API Lemon Squeezy moi-même ?
Non. Connect fournit 12 tools Lemon Squeezy décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Lemon Squeezy ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
