Búsqueda de pagos recibidos

API RESTful / JSON

La API para búsqueda de pagos es un servicio que te permite obtener la información de un pago determinado o múltiples pagos aplicando diferentes filtros.

Configura la API


Ejemplos de búsqueda

Pagos acreditados del último mes:

curl -X GET \
-H 'accept: application/json' \
'https://api.mercadolibre.com/collections/search?access_token=tu_access_token&status=approved&operation_type=regular_payment&range=date_created&begin_date=NOW-1MONTH&end_date=NOW'

Pagos acreditados con tarjeta de crédito en un período específico:

curl -X GET \
-H 'accept: application/json' \
'https://api.mercadolibre.com/collections/search?access_token=tu_access_token&payment_type=credit_card&operation_type=regular_payment&range=date_created&begin_date=2011-10-21T00:00:00Z&end_date=2011-10-25T24:00:00Z'

Pagos financiados en 12 veces de un item específico (no aplica para Venezuela):

curl -X GET \
-H 'accept: application/json' \
'https://api.mercadolibre.com/collections/search?access_token=tu_access_token&payment_type=credit_card&operation_type=regular_payment&installments=12&reason=Título de lo que estás pagando'

Pagos realizados por direcciones de e-mail específicas:

curl -X GET \
-H 'accept: application/json' \
'https://api.mercadolibre.com/collections/search?access_token=tu_access_token&payment_type=credit_card&operation_type=regular_payment&payer_email=payer1@email.com%20payer2@email.com&range=date_created&begin_date=2011-01-01T00:00:00Z&end_date=2011-02-01T00:00:00Z'

Pagos realizados a un external_reference específico:

curl -X GET \
-H 'accept: application/json' \
'https://api.mercadolibre.com/collections/search?access_token=tu_access_token&external_reference=ext1425'

Filtros de búsqueda

AtributoDescripción
id Identificador del pago.
site_id Identificador de país. Argentina: MLA; Brasil: MLB. México: MLM. Venezuela: MLV. Colombia: MCO.
date_created Fecha de creación. Ej: range=date_created&begin_date=NOW-1DAYS&end_date=NOW (Ver ISO-8601)
date_approved Fecha de aprobación. Ej: range=date_approved&begin_date=NOW-1DAYS&end_date=NOW (Ver ISO-8601)
last_modifiedFecha de última modificación. Ej: range=last_modified&begin_date=NOW-1DAYS&end_date=NOW (Ver ISO-8601)
money_release_dateFecha de liberación del cobro. Ej: range=money_release_date&begin_date=NOW-1DAYS&end_date=NOW (Ver ISO-8601)
payer_id Identificador del comprador.
reason Descripción de lo que se está pagando.
transaction_amountValor de la transacción.
currency_id Tipo de moneda. Argentina: ARS (Peso argentino); Brasil: BRL (Real); México: MXN (Peso Mexicano); Venezuela: VEF (Bolívar fuerte); Colombia: COP (Peso colombiano).
external_reference Referencia que puedes utilizar para vincular el pago a tu sistema.
mercadopago_fee Comisión por el uso de MercadoPago.
net_received_amount Monto que recibe el vendedor sin incluir el mercadopago_fee.
total_paid_amountMonto total obtenido de la suma de los siguientes atributos: transaction_amount, shipping_cost y el monto que pagó el comprador (incluyendo la financiación para tarjetas de crédito).
shipping_cost Monto de envío.
status Estado del pago
pending El usuario no completó el proceso de pago.
approved El pago fue aprobado y acreditado.
in_process El pago está siendo revisado.
rejected El pago fue rechazado. El usuario puede intentar nuevamente.
cancelled El pago fue cancelado por superar el tiempo necesario para realizar el pago o por una de las partes.
refunded El pago fue devuelto al usuario.
in_mediation Se inició una disputa para el pago.
charged_back Se realizó un contracargo en la tarjeta de crédito.
status_detail Detalle del estado del cobro.
released Disponibilidad del monto a cobrar. Valores posibles: yes, no.
operation_type Tipo de operación
regular_payment Pago.
money_transfer Envío de dinero.
recurring_payment Pago recurrente por suscripción activa.
subscription_payment Pago junto a inicio de suscripción.

Parámetros de paginado

Parámetro Descripción
limit Cantidad de registros que se requieren (valor máximo = 50). Si no se define, devuelve hasta 30 registros encontrados. Ej: 12.
offset Posición a partir de la cual se desea que devuelvan los registros. Por defecto el valor es 0 (máximo permitido: 10000).
sort Establece un criterio a partir del cual se ordenan los resultados. Ej: sort=external_reference, sort=date_created, sort=status, etc.
criteria Orden de los datos. Puede ser asc (ascendente) o desc (descendente).