Créer un checkout avec l'API Lemon Squeezy
Crée un lien de checkout pour une variante, avec en option un prix personnalisé, des données d'acheteur préremplies, un code de remise et une expiration, et le renvoie avec le lien dans data.attributes.url. Les champs vont dans data, en JSON:API : type, attributes, et la boutique et la variante dans relationships.
- Identifiant
- lemon_squeezy_create_checkout
L'appel
POST https://connect.reportei.com/api/tools/lemon_squeezy_create_checkout/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"data": {}
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| data | object | Oui | The new checkout. |
Connexions possibles
Votre client connecte son compte Lemon Squeezy une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
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.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/lemon_squeezy_create_checkout. Il devient la définition de tool de votre agent sans conversion.
Autres 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.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
