Buscar en pagos - Pagos - Mercado Pago Developers
Buscar en pagos

GET

/v1/payments/search
Busca y retorna los pagos hechos en los último doce meses desde la fecha de pago.
Parámetros para la solicitud
sort

REQUERIDO

string
Localización: queryDefine el campo para ordenar
criteria

REQUERIDO

string
Localización: queryFiltro utilizado en la búsqueda
external_reference

REQUERIDO

string
Localización: queryIdentificador único que envía el vendedor para relacionar el payment_id generado por mercado pago, con el ID de tu sistema.
Parámetros de respuesta
paging
object
Localización: bodyInformación para paginación de resultados de búsqueda.
results
array
Localización: bodyResultados de la búsqueda
Solicitud
curl
curl -X GET \
    'https://api.mercadopago.com/v1/payments/search?sort=date_created&criteria=desc&external_reference=ID_REF' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' 
Respuesta
json
[
  {
    "paging": {
      "total": 17493,
      "limit": 30,
      "offset": 0
    },
    "results": [
      {
        "id": 1,
        "date_created": "2017-08-31T11:26:38.000Z",
        "date_approved": "2017-08-31T11:26:38.000Z",
        "date_last_updated": "2017-08-31T11:26:38.000Z",
        "money_release_date": "2017-09-14T11:26:38.000Z",
        "payment_method_id": "account_money",
        "payment_type_id": "credit_card",
        "status": "approved",
        "status_detail": "accredited",
        "currency_id": "BRL",
        "description": "Pago Pizza",
        "collector_id": 2,
        "payer": {
          "id": 123,
          "email": "afriend@gmail.com",
          "identification": {
            "type": "DNI",
            "number": 12345678
          },
          "type": "customer"
        },
        "metadata": {},
        "additional_info": {},
        "order": {},
        "transaction_amount": 250,
        "transaction_amount_refunded": 0,
        "coupon_amount": 0,
        "transaction_details": {
          "net_received_amount": 250,
          "total_paid_amount": 250,
          "overpaid_amount": 0,
          "installment_amount": 250
        },
        "installments": 1,
        "card": {}
      }
    ]
  }
]
Errores
400bad_request
1Error de parámetros.
3El token debe ser para test.
5Debes proveer tu access_token para proceder.
1000El número de filas excede los límites.
1001El formato de fecha debe ser yyyy-MM-dd'T'HH:mm:ss.SSSZ.
1003Valor de clasificación no válido.
1004Valor de criterio inválido.
2001Ya se posteó el mismo request en el último minuto.
2002Cliente no encontrado.
2004Falló el POST a Gateway Transactions API.
2006Card Token no encontrado.
2007Falló la conexión a Card Token API.
2009Card token issuer no puede ser nulo.
3000Debes proveer el parámetro cardholder_name en card data.
3001Debes proveer el parámetro cardholder_name en card data.
3003card_token_id inválido.
3004parameter site_id inválido.
3005Acció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.
3006cardtoken_id inválido.
3007El parámetro client_id no puede ser nulo ni vacío.
3008Cardtoken no encontrado.
3009client_id no autorizado.
3010La tarjeta no se encuentra en la lista blanca.
3011payment_method no encontrado.
3012security_code_length inválido.
3013El parámetro security_code es requerido y no puede ser nulo ni vacío.
3014payment_method inválido.
3015card_number_length inválido.
3016card_number inválido.
3017El parámetro card_number_id no puede ser nulo ni vacío.
3018El parámetro expiration_month no puede ser nulo ni vacío.
3019El parámetro expiration_year no puede ser nulo ni vacío.
3020El parámetro cardholder.name no puede ser nulo ni vacío.
3021El parámetro cardholder.document.number no puede ser nulo ni vacío.
3022El parámetro cardholder.document.type no puede ser nulo ni vacío.
3023El parámetro cardholder.document.subtype no puede ser nulo ni vacío.
3024Acción inválida, reembolsos parciales no soportados para esta transacción.
3025Código de autorización inválido.
3026card_id inválido para este payment_method_id.
3027payment_type_id inválido.
3028payment_method_id inválido.
3029Mes de expiración de tarjeta inválido.
3030Año de expiración de tarjeta inválido.
403bad_request
4El usuario no esta autorizado a acceder a este recurso.
3002El usuario no está autorizado a realizar esta acción.
404bad_request
2000No se ha encontrado el pago.