Modifier une préférence avec l'API Mercado Pago
Modifie 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.
- Identifiant
- mercado_pago_update_preference
L'appel
POST https://connect.reportei.com/api/tools/mercado_pago_update_preference/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"preference_id": "<preference_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 |
|---|---|---|---|
| preference_id | string | Oui | Id of the preference, from Search preferences or Create preference. |
| items | array | Non | Products or services of the payment. The total is the sum of quantity times unit_price. |
| payer | object | Non | Buyer data that fills in the checkout. |
| payment_methods | object | Non | Payment options of the checkout. |
| back_urls | object | Non | Pages of the seller's site the buyer returns to after the checkout. |
| auto_return | string | Non | approved sends the buyer to back_urls.success right after an approved card payment. Needs back_urls.success.Valeurs : approved, all |
| external_reference | string | Non | Your own code for this sale. Its payments carry it, so Search payments finds them by it. |
| expires | boolean | Non | true makes the link valid only between expiration_date_from and expiration_date_to. |
| expiration_date_from | string | Non | Start of the validity, like 2026-11-01T00:00:00.000-03:00. |
| expiration_date_to | string | Non | End of the validity, in the same format as expiration_date_from. A past date closes the link. |
| metadata | object | Non | Free key-value data saved with the preference. |
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_preference. 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.
- 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.
- Créer un plan d'abonnementPOSTCrée un plan d'abonnement et le renvoie avec id et init_point, le lien où les acheteurs s'abonnent par carte. Exige reason, back_url et auto_recurring avec frequency, frequency_type et currency_id.
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