/v1/payments/search
BASE URI https://api.mercadopago.com/v1/payments/search
HTTP Request
curl
curl -X GET \
'https://api.mercadopago.com/v1/payments/search?sort=date_created&criteria=desc&external_reference="ID_REF"' \
-H 'Authorization: Bearer ACCESS_TOKEN'
Request Params
ParameterTypeDescription
id
Long
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.
HTTP Response
json
{
"paging": {
"total": 17493,
"limit": 30,
"offset": 0
},
"results": [
{
"id": "0000001",
"date_created": "2017-08-31T07:26:38.000-04:00",
"date_approved": "2017-08-31T07:26:38.000-04:00",
"date_last_updated": "2017-08-31T07:26:38.000-04:00",
"date_of_expiration": null,
"money_release_date": "2017-09-14T07:26:38.000-04:00",
"operation_type": "money_transfer",
"issuer_id": null,
"payment_method_id": "account_money",
"payment_type_id": "account_money",
"status": "approved",
"status_detail": "accredited",
"currency_id": "[FAKER][CURRENCY][ACRONYM]",
"description": "Pago Pizza",
"live_mode": true,
"sponsor_id": null,
"authorization_code": null,
"money_release_schema": null,
"counter_currency": null,
"collector_id": "0000002",
"payer": {
"type": "registered",
"id": "000001",
"email": "afriend@gmail.com",
"identification": {
"type": "DNI",
"number": "12345678"
},
"phone": {
"area_code": null,
"number": "11123456789",
"extension": null
},
"first_name": "Name",
"last_name": "LastName",
"entity_type": null
},
"metadata": {},
"additional_info": {},
"order": {},
"external_reference": null,
"transaction_amount": 250,
"transaction_amount_refunded": 0,
"coupon_amount": 0,
"differential_pricing_id": null,
"deduction_schema": null,
"transaction_details": {
"net_received_amount": 250,
"total_paid_amount": 250,
"overpaid_amount": 0,
"external_resource_url": null,
"installment_amount": 250,
"financial_institution": null,
"payment_method_reference_id": null,
"payable_deferral_period": null,
"acquirer_reference": null
},
"fee_details": [],
"captured": true,
"binary_mode": false,
"call_for_authorize_id": null,
"statement_descriptor": null,
"installments": 1,
"card": {},
"notification_url": null,
"refunds": [],
"processing_mode": null,
"merchant_account_id": null,
"acquirer": null,
"merchant_number": null,
"acquirer_reconciliation": []
}
{
"id": "0000002",
...
},
{
"id": "0000003",
...
},
{
"id": "0000030",
}
]
}
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.