Rechercher des paiements avec l'API Mercado Pago
Recherche 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.
- Identifiant
- mercado_pago_search_payments
L'appel
POST https://connect.reportei.com/api/tools/mercado_pago_search_payments/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"sort": "date_approved"
}
}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 |
|---|---|---|---|
| sort | string | Non | Field that orders the results.Valeurs : date_approved, date_created, date_last_updated, id, money_release_date |
| criteria | string | Non | Direction of sort: asc or desc.Valeurs : asc, desc |
| range | string | Non | Date field that begin_date and end_date filter. The default is date_created.Valeurs : date_created, date_last_updated, date_approved, money_release_date |
| begin_date | string | Non | Start of the period: an ISO 8601 date, like 2026-09-01T00:00:00.000-03:00, or a relative one, like NOW-30DAYS or NOW-1MONTH. The default is NOW-3MONTHS. |
| end_date | string | Non | End of the period, in the same formats as begin_date. The default is NOW. |
| external_reference | string | Non | Only the payments with this external_reference, the seller's own code set on the preference or the payment. |
| limit | integer | Non | Payments per page. |
| offset | integer | Non | Payments to skip, for paging. |
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_payments. Il devient la définition de tool de votre agent sans conversion.
Autres tools Mercado Pago
- 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.
- 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