/v1/payments/search

BASE URI https://api.mercadopago.com/v1/payments/search

Request Params

ParameterTypeDescription
id Integer Identificador de pago.
date_created Date(ISO_8601) Fecha de creación del pago.
date_approved Date(ISO_8601) Fecha de aprobación del pago.
date_last_updated Date(ISO_8601) Fecha de la última modificación.
money_release_date Date(ISO_8601) Fecha de liberación del pago.
operation_type String Tipo de pago.
regular_payment Tipificación por defecto de una compra pagada con Mercado Pago.
money_transfer Transferencia de fondos entre usuarios.
recurring_payment Pago recurrente automático por una suscripción de un usuario activo.
account_fund Ingreso de fondos en la cuenta del usuario.
payment_addition Agregado de dinero a un pago existente realizado en el sitio de Mercado Pago.
cellphone_recharge Recarga de la cuenta telefónica de un usuario.
pos_payment Pago realizado en un dispositivo POS.
payer Object Identificador del pagador.
entity_type String Tipo de entidad del pagador (sólo para transferencias bancarias).
individual El pagador es único.
association El pagador es una asociación.
type String Tipo de identificación del pagador asociado (requerido si el pagador es un cliente).
customer El pagador es un cliente y pertenece al collector.
registered La cuenta corresponde a un usuario registrado de Mercado Pago.
guest El pagador no tiene una cuenta.
id String Identificación del pagador asociado.
email String Email. (Obligatorio)
identification Object Identificación personal.
type String Tipo de identificación.
number String Número de identificación.
phone Object Teléfono del pagador asociado.
area_code String Código de área.
number String Número de teléfono.
extension String Extensión del número de teléfono.
first_name String Nombre del pagador asociado.
last_name String Apellido del pagador asociado.
binary_mode Boolean Cuando está activado el pago solo puede resultar aprobado o rechazado. De no estar activado, además de este estado el pago puede resultar pendiente (in_process).
live_mode Boolean Indica si el pago se procesará en entorno de sandbox o producción.
order Object Identificador de orden.
type String Tipo de orden.
mercadolibre La orden es de Mercado Libre.
mercadopago Es una merchant_order de Mercado Pago.
id Long Identificador de la orden de compra asociada.
external_reference String Identificador provisto por el vendedor en su sistema.
description String Razón de pago o título de ítem.
metadata Object JSON válido que puede agregarse al pago para guardar atributos adicionales del comprador.
currency_id String(3) Identificador de la moneda utilizada en el pago.
ARS Peso argentino.
BRL Real brasilero.
CLP Peso chileno.
MXN Peso mexicano.
COP Peso colombiano.
PEN Sol peruano.
UYU Peso uruguayo.
transaction_amount Float Costo del producto. (Obligatorio)
transaction_amount_refunded Float Monto total reembolsado en este pago.
transaction_details Object Agrupa los detalles de la transacción.
financial_institution String Identificador de la institución financiera externa (ej.: company id para atm)
net_received_amount Float Monto recibido por el vendedor.
total_paid_amount Float Monto pagado por el comprador (incluye comisiones).
installment_amount Float Monto total de cuota.
overpaid_amount Float Monto pagado por demás (sólo para tickets).
external_resource_url String Identifica el recurso en el procesador de pago.
payment_method_reference_id String Para pagos con tarjeta de crédito es USN. Para medios de pago offline es la referencia para darle al cajero o ingresarla en el ATM.
fee_details Array(Object) Lista de comisiones.
type String Detalle de comisión.
mercadopago_fee Costo de usar Mercado Pago.
coupon_fee Descuento otorgado por un cupón.
financing_fee Costo de financiación.
shipping_fee Costo de envío.
application_fee Comisión de servicio del Marketplace.
discount_fee Descuento otorgado por el vendedor absorviendo el costo.
fee_payer String Indica quién absorve el costo de la comisión.
collector El vendedor absorve el costo.
payer El comprador absorve el costo.
amount Float Monto de la comisión.
status String Estado del pago.
pending El usuario no completo el proceso de pago todavía.
approved El pago fue aprobado y acreditado.
authorized El pago fue autorizado pero no capturado todavía.
in_process El pago está en revisión.
in_mediation El usuario inició una disputa.
rejected El pago fue rechazado. El usuario podría reintentar el pago.
cancelled El pago fue cancelado por una de las partes o el pago expiró.
refunded El pago fue devuelto al usuario.
charged_back Se ha realizado un contracargo en la tarjeta de crédito del comprador.
status_detail String Brinda información detallada del estado actual o el motivo de rechazo.
captured Boolean Determina si la captura de la operación fue realizada (sólo para tarjetas de crédito).
call_for_authorize_id String Identificador que debe ser provisto al banco emisor para autorizar el pago.
payment_method_id String Medio de pago elegido para hacer el pago. (Obligatorio)
issuer_id String Identificador del emisor del medio de pago.
payment_type_id String Tipo del medio de pago elegido.
account_money Dinero en la cuenta de Mercado Pago.
ticket Ticket impreso.
bank_transfer Transferencia bancaria.
atm Pago en ATM.
credit_card Pago con tarjeta de crédito.
debit_card Pago con tarjeta de débito.
prepaid_card Pago con tarjeta prepaga.
card Object Detalles de la tarjeta utilizada.
id Number Identificador de la tarjeta.
last_four_digits String Últimos cuatro dígitos del número de la tarjeta.
first_six_digits String Primeros seis dígitos del número de la tarjeta.
expiration_year Integer Año de expiración de la tarjeta.
expiration_month Integer Mes de expiración de la tarjeta.
date_created Date(ISO_8601) Fecha de creación de la tarjeta.
date_last_updated Date(ISO_8601) Fecha de última actualización de la información de la tarjeta.
cardholder Object Información sobre el dueño de la tarjeta.
name String Nombre del propietario de la tarjata.
identification Object Identificación del propietario de la tarjeta.
number String Número de documento.
type String Tipo de documento.
statement_descriptor String Cómo aparecerá el pago en el resumen de tarjeta (ej.: MERCADOPAGO).
installments Integer Cantidad seleccionada de cuotas. (Obligatorio)
notification_url String URL a la cual Mercado Pago enviará notificaciones asociadas a cambios en el estado del pago.
refunds Array(Object) Lista de reembolsos que fueron realizados a este pago.
id Number Identificador de reembolso.
payment_id Number Identificador del pago al cual se le hizo un reembolso.
amount Float Monto reembolsado.
metadata Object JSON válido que puede agregarse al pago para guardar atributos adicionales del comprador.
source Object Indica quién hizo el reembolso.
id String Identificador del usuario que hizo el reembolso.
name String Nombre del usuario que hizo el reembolso.
type String Tipo de usuario que hizo el reembolso.
collector El vendedor hizo el reembolso.
operator Un operador de cuenta hizo el reembolso.
admin El reembolso fue realizado por un administrador de Mercado Pago.
bpp El reembolso fue realizado por el programa de protección al comprador de Mercado Pago.
date_created Date(ISO_8601) Fecha del reembolso.
unique_sequence_number String Identificador de reembolso otorgado por el procesador de tarjeta.

Error Codes

CodeDescription
404 NOT_FOUND
2000 No se ha encontrado el pago.
403 FORBIDDEN
4 El usuario no esta autorizado a acceder a este recurso.
3002 El usuario no está autorizado a realizar esta acción.
400 BAD_REQUEST
1 Error de parámetros.
3 El token debe ser para test.
5 Debes proveer tu access_token para proceder.
1000 El número de filas excede los límites.
1001 El formato de fecha debe ser yyyy-MM-dd'T'HH:mm:ss.SSSZ.
1003 Valor de clasificación no válido.
1004 Valor de criterio inválido.
2001 Ya se posteó el mismo request en el último minuto.
2004 Falló el POST a Gateway Transactions API.
2002 Cliente no encontrado.
2006 Card Token no encontrado.
2007 Falló la conexión a Card Token API.
2009 Card token issuer no puede ser nulo.
3000 Debes proveer el parámetro cardholder_name en card data.
3001 Debes proveer el parámetro cardholder_name en card data.
3003 card_token_id inválido.
3004 parameter site_id inválido.
3005 Acción inválida, el recurso esta en un estado que no permite esta operación. Para más información consulta el estado del recurso.
3006 cardtoken_id inválido.
3007 El parámetro client_id no puede ser nulo ni vacío.
3008 Cardtoken no encontrado.
3009 client_id no autorizado.
3010 La tarjeta no se encuentra en la lista blanca.
3011 payment_method no encontrado.
3012 security_code_length inválido.
3013 El parámetro security_code es requerido y no puede ser nulo ni vacío.
3014 payment_method inválido.
3015 card_number_length inválido.
3016 card_number inválido.
3017 El parámetro card_number_id no puede ser nulo ni vacío.
3018 El parámetro expiration_month no puede ser nulo ni vacío.
3019 El parámetro expiration_year no puede ser nulo ni vacío.
3020 El parámetro cardholder.name no puede ser nulo ni vacío.
3021 El parámetro cardholder.document.number no puede ser nulo ni vacío.
3022 El parámetro cardholder.document.type no puede ser nulo ni vacío.
3023 El parámetro cardholder.document.subtype no puede ser nulo ni vacío.
3024 Acción inválida, reembolsos parciales no soportados para esta transacción.
3025 Código de autorización inválido.
3026 card_id inválido para este payment_method_id.
3027 payment_type_id inválido.
3028 payment_method_id inválido.
3029 Mes de expiración de tarjeta inválido.
3030 Año de expiración de tarjeta inválido.

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.