E-commerce
Recharge dans votre produit et vos agents IA, via une API
Le toolkit Recharge couvre les abonnements (lister, lire, créer, mettre à jour, annuler, réactiver, déplacer la date du prochain prélèvement), les clients et les prélèvements (lister, lire, sauter). Connect stocke la clé d'API de chaque boutique et journalise chaque exécution, pour que votre produit ou agent IA gère les commandes récurrentes sans construire l'intégration.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/recharge_create_subscription/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"address_id": 1,
"external_variant_id": {},
"quantity": 1,
"next_charge_scheduled_at": "<next_charge_scheduled_at>",
"order_interval_unit": "day",
"order_interval_frequency": 1,
"charge_interval_frequency": 1
}
}Fonctionnement
Du client connecté au premier appel à Recharge.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Recharge. 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 Recharge.
Portail d'abonnements en libre-service
Affichez les abonnements d'un client et laissez-le changer la fréquence ou la quantité, sauter le prochain prélèvement ou résilier, depuis votre propre interface.
Reconquérir les abonnés résiliés
Listez les abonnements annulés et réactivez-en un avec Activate subscription, ou définissez une nouvelle date de prélèvement avec Set subscription next charge date.
Agent de support pour boutiques d'abonnement
Un agent IA retrouve le client par e-mail, lit ses prélèvements et abonnements et saute un prélèvement en file quand le client le demande.
Tools
12 tools Recharge
- Lister les abonnementsGETListe les abonnements de la boutique avec client, adresse, produit, quantité, prix, fréquence, statut et next_charge_scheduled_at. Jusqu'à 250 par page : passez le next_cursor de la réponse en cursor pour lire la page suivante.
- Consulter un abonnementGETRenvoie un abonnement avec produit, quantité, prix, fréquence, statut, motif d'annulation et next_charge_scheduled_at.
- Créer un abonnementPOSTCrée un abonnement sur une adresse d'un client et le renvoie. Le produit doit avoir au moins un plan dans Recharge. Les champs de fréquence, la date du premier prélèvement, la variante, la quantité et l'adresse sont obligatoires.
- Mettre à jour un abonnementPUTModifie un abonnement actif et le renvoie. Changer order_interval_unit, order_interval_frequency ou charge_interval_frequency exige les trois, recalcule la date du prochain prélèvement et supprime les prélèvements sautés et modifiés manuellement. Pour ne déplacer que le prochain prélèvement, utilisez Set subscription next charge date.
- Annuler un abonnementPOSTAnnule un abonnement actif et le renvoie. Recharge peut envoyer un e-mail au client et au propriétaire de la boutique à ce sujet, sauf si send_email vaut false.
- Réactiver un abonnementPOSTRéactive un abonnement annulé et le renvoie, en effaçant la date et le motif d'annulation.
- Définir la date du prochain prélèvementPOSTDéplace le prochain prélèvement d'un abonnement à une autre date et renvoie l'abonnement. Quand deux abonnements actifs de la même adresse se retrouvent à la même date, leurs prélèvements sont fusionnés en un nouveau prélèvement avec un nouvel id.
- Lister les clientsGETListe les clients de la boutique avec e-mail, nom, le nombre d'abonnements actifs et si le moyen de paiement est valide ou en relance (dunning). Filtrez par e-mail pour retrouver un client. Jusqu'à 250 par page : passez le next_cursor de la réponse en cursor.
- Consulter un clientGETRenvoie un client. Avec include, la réponse contient aussi les adresses, abonnements ou moyens de paiement du client ; l'id de chaque adresse est l'address_id que prend Create subscription.
- Lister les prélèvementsGETListe les prélèvements de la boutique, passés et à venir, avec statut, scheduled_at, processed_at, totaux, client et lignes. Les prélèvements traités depuis plus de 90 jours ne sont pas renvoyés. Triés par id croissant par défaut ; jusqu'à 250 par page : passez le next_cursor de la réponse en cursor pour lire la page suivante.
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 Recharge
Dois-je intégrer l'API Recharge moi-même ?
Non. Connect fournit 12 tools Recharge 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 Recharge ?
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.
