Rechercher des préférences avec l'API Mercado Pago
Liste 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.
- Identifiant
- mercado_pago_search_preferences
L'appel
POST https://connect.reportei.com/api/tools/mercado_pago_search_preferences/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"external_reference": "<external_reference>"
}
}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 |
|---|---|---|---|
| external_reference | string | Non | Only the preferences with this external_reference. |
| limit | integer | Non | Preferences per page. The default is 30. |
| offset | integer | Non | Preferences to skip, like the next_offset of the previous response. The default is 0. |
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_search_preferences. 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.
- 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.
- 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