Modifier un plan d'abonnement avec l'API Mercado Pago
Modifie les champs envoyés d'un plan d'abonnement, comme le nom, le montant ou le cycle. L'id et le lien init_point restent les mêmes.
- Identifiant
- mercado_pago_update_subscription_plan
L'appel
POST https://connect.reportei.com/api/tools/mercado_pago_update_subscription_plan/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"plan_id": "<plan_id>"
}
}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 |
|---|---|---|---|
| plan_id | string | Oui | Id of the plan, from Search subscription plans or Create subscription plan. |
| reason | string | Non | Name of the plan, shown to the subscriber at checkout and in the notifications. |
| auto_recurring | object | Non | Amount and cycle of the charges. frequency_type goes with any change here. |
| payment_methods_allowed | object | Non | Payment types and methods the subscriber can use. |
| back_url | string | Non | Page of the seller's site the subscriber returns to after subscribing. |
Connexions possibles
Votre client connecte son compte Mercado Pago 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/mercado_pago_update_subscription_plan. Il devient la définition de tool de votre agent sans conversion.
Autres tools Mercado Pago
- Rechercher des paiementsGETRecherche les paiements reçus par le compte au cours des 12 derniers mois ; sans dates, ceux créés au cours des 3 derniers mois. La réponse contient results et paging avec total, limit et offset : augmentez offset de limit pour lire la page suivante.
- Obtenir un paiementGETRenvoie un paiement : status et status_detail, transaction_amount, transaction_details avec le montant net reçu, moyen et type de paiement, échéances, payeur et dates.
- Modifier un paiementPUTAnnule un paiement encore pending, in_process ou authorized, comme un boleto ou un Pix impayé, ou change la date d'expiration d'un paiement en attente. Un paiement approuvé n'est pas annulé ici : il est remboursé dans Mercado Pago.
- Rechercher des préférencesGETListe les préférences de paiement, les liens de checkout, créées au cours des 90 derniers jours. La réponse contient elements, next_offset et total. Le lien lui-même, init_point, vient de Obtenir une préférence.
- Obtenir une préférenceGETRenvoie une préférence de paiement avec ses articles, son payeur, ses réglages de paiement, sa validité et init_point, le lien de checkout à envoyer à l'acheteur. Fonctionne pour les préférences de tout âge.
- Créer une préférencePOSTCrée une préférence de paiement et la renvoie avec id et init_point, le lien Checkout Pro où l'acheteur paie par Pix, carte, boleto ou solde Mercado Pago. Chaque article a besoin de id, title, quantity et unit_price. Partagez init_point avec l'acheteur.
- Modifier une préférencePUTModifie les champs envoyés d'une préférence de paiement, comme les articles, les prix, les données de l'acheteur ou la validité. L'id et le lien init_point restent les mêmes.
- Rechercher des plans d'abonnementGETRecherche les plans d'abonnement du compte. Chaque plan dans results a id, reason, auto_recurring, status, subscribed (combien d'abonnés) et init_point, le lien où un acheteur s'abonne. Paginez avec offset et limit ; paging donne le total.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.

Conta Azul