Buscar en pagos - Pagos - Mercado Pago Developers
¿Qué documentación quieres buscar?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos
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: queryParámetro utilizado para ordenar una lista de pagos. La clasificación se puede hacer usando los siguientes atributos - "date_approved", "date_created", "date_last_updated", "id", "money_release_date".
criteria

REQUERIDO

string
Localización: queryOrdena el pago en orden ascendente (usando "asc") o en orden descendente ("desc").
external_reference

REQUERIDO

string
Localización: queryEs una referencia de pago externa. Podría ser, por ejemplo, un código hash del Banco Central, funcionando como identificador del origen de la transacción.
range

REQUERIDO

string
Localización: queryParámetro utilizado para definir el intervalo de búsqueda de pagos. El rango puede hacer referencia a los siguientes atributos - "date_created", "date_last_updated", "date_approved", "money_release_date". Si no se informa, usa por defecto "date_created"
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&range=date_created&begin_date=NOW-30DAYS&end_date=NOW' \
       -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": "test_user_80507629@testuser.com",
          "identification": {
            "type": "CPF",
            "number": 19119119100
          },
          "type": "customer"
        },
        "metadata": {},
        "additional_info": {},
        "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
1Params Error.
3Token must be for test.
5Must provide your access_token to proceed.
1000Number of rows exceeded the limits.
1001Date format must be yyyy-MM-dd'T'HH:mm:ss.SSSZ.
1003Invalid sort value.
1004Invalid criteria value.
2001Already posted the same request in the last minute.
2002Customer not found.
2004POST to Gateway Transactions API fail.
2006Card Token not found.
2007Connection to Card Token API fail.
2009Card token issuer can't be null.
3000You must provide your cardholder_name with your card data.
3001You must provide your cardissuer_id with your card data.
3003Invalid card_token_id.
3004Invalid parameter site_id.
3005Not valid action, the resource is in a state that does not allow this operation. For more information see the state that has the resource.
3006Invalid parameter cardtoken_id.
3007The parameter client_id can not be null or empty.
3008Not found Cardtoken.
3009unauthorized client_id.
3010Not found card on whitelist.
3011Not found payment_method.
3012Invalid parameter security_code_length.
3013The parameter security_code is a required field can not be null or empty.
3014Invalid parameter payment_method.
3015Invalid parameter card_number_length.
3016Invalid parameter card_number.
3017The parameter card_number_id can not be null or empty.
3018The parameter expiration_month can not be null or empty.
3019The parameter expiration_year can not be null or empty.
3020The parameter cardholder.name can not be null or empty.
3021The parameter cardholder.document.number can not be null or empty.
3022The parameter cardholder.document.type can not be null or empty.
3023The parameter cardholder.document.subtype can not be null or empty.
3024Not valid action - partial refund unsupported for this transaction.
3025Invalid Auth Code.
3026Invalid card_id for this payment_method_id.
3027Invalid payment_type_id.
3028Invalid payment_method_id.
3029Invalid card expiration month.
3030Invalid card expiration year.
9062Invalid range interval - Must be less than 365 days.
403bad_request
4The caller is not authorized to access this resource.
3002The caller is not authorized to perform this action.
404bad_request
2000 Payment not found.