Mercado Pago - Get Payments

Description

Searches and gets payments from Mercado Pago with advanced filters. Allows searching by ID, external reference, status, date range, and more.

Configuration

Field	Type	Required	Description
credentials_id	credential	Yes	Mercado Pago credentials
payment_id	string	No	Specific payment ID
external_reference	string	No	Filter by external reference
status	select	No	Payment status (approved, pending, rejected, etc.)
begin_date	string	No	Start date (ISO 8601)
end_date	string	No	End date (ISO 8601)
sort	select	No	Sort field (date_created, date_approved, etc.)
criteria	select	No	Ascending or descending order
limit	number	No	Number of results (default: 10)
offset	number	No	Offset for pagination

Credentials

This module requires a mercadopago type credential with the following fields:

• Access Token: Mercado Pago access token (obtained from the developer dashboard)

Output

{
  "success": true,
  "payment": { ... },
  "payments": [ ... ],
  "paging": {
    "total": 100,
    "offset": 0,
    "limit": 10
  }
}

Payment Statuses

• approved: Payment approved
• pending: Payment pending
• in_process: In process
• rejected: Rejected
• cancelled: Canceled
• refunded: Refunded
• charged_back: Chargeback

Usage Example

1. Get a specific payment by ID
2. Search all approved payments from the last month
3. List payments with a specific external reference

API Used

• Endpoint: GET /v1/payments/{id} or GET /v1/payments/search
• Documentation: Mercado Pago Payments API

Notes

• If payment_id is provided, a single payment is returned
• Without payment_id, a search is performed with the provided filters
• Results are paginated with limit and offset
• Dates must be in ISO 8601 format

Related Nodes

• MercadopagoCreatePayment - Create payment
• MercadopagoCreateRefund - Create refund
• MercadopagoGetCustomers - Get customers