/v1/advanced_payments/:id/search

BASE URI https://api.mercadopago.com/v1/advanced_payments/{id}/search

HTTP Request

curl

 curl -X GET \
  'https://api.mercadopago.com/v1/advanced_payments/search?limit=10&offset=0&range=date&begin_date=2018-02-01&end_date=2018-12-02' \
  -H 'Authorization: Bearer MKT_ACCESS_TOKEN'
 

Request Params

ParameterTypeDescription
status String Status do Advanced Payment.
pending O usuário ainda não concluiu o processo de pagamento.
approved O pagamento foi aprovado e creditado.
rejected O pagamento foi recusado. O usuário poderia tentar fazer o pagamento novamente.
cancelled O pagamento foi cancelado por uma das partes ou expirou.
refunded O pagamento foi devolvido para o usuário.
partially_refunded Parte do pagamento foi devolvido para o usuário.
charged_back Uma contestação foi feita no cartão de crédito do comprador.
date_created Date(ISO_8601) Data de criação do pagamento.

HTTP Response

json

 {
  "paging": {
    "total": 1,
    "limit": 10,
    "offset": 0
  },
  "results": [
    {
      "id": 111111111,
      "status": "approved",
      "payments": [
        {
          "id": 222222222,
          "status": "approved",
          "status_detail": "accredited",
          "payment_type_id": "credit_card",
          "payment_method_id": "visa",
          "token": "98f6a9s7dfyihfasfdhasdjfhñasdfh",
          "transaction_amount": 100,
          "installments": 1,
          "processing_mode": "aggregator",
          "description": "Payment description",
          "capture": true,
          "external_reference": "ext_ref_payment",
          "statement_descriptor": "MKT-STATEMENT-DESCRIPTION"
        }
      ],
      "disbursements": [
        {
          "id": 33333333,
          "amount": 40,
          "external_reference": "ext_ref_disb_1",
          "collector_id": 31313,
          "application_fee": 5,
          "money_release_days": 10,
          "additional_info": {
            "items": [
              {
                "id": "item-ID-1234",
                "title": "Title of what you are paying for",
                "picture_url": "https://www.mercadopago.com/logomp3.gif",
                "description": "Item description",
                "category_id": "art",
                "quantity": 1,
                "unit_price": 100
              }
            ],
            "shipments": {
              "receiver_address": {
                "zip_code": "5700",
                "street_name": "Street",
                "street_number": 123,
                "floor": 4,
                "apartment": "C"
              }
            }
          }
        },
        {
          "id": 44444444,
          "amount": 60,
          "external_reference": "ext_ref_disb_2",
          "collector_id": 41414,
          "application_fee": 10,
          "money_release_days": 30,
          "additional_info": {
            "items": [
              {
                "id": "item-ID-4512",
                "title": "Title of what you are paying for",
                "picture_url": "https://www.mercadopago.com/logomp3.gif",
                "description": "Item description",
                "category_id": "art",
                "quantity": 1,
                "unit_price": 100
              }
            ],
            "shipments": {
              "receiver_address": {
                "zip_code": "5700",
                "street_name": "Street",
                "street_number": 123,
                "floor": 4,
                "apartment": "C"
              }
            }
          }
        }
      ],
      "payer": {
        "email": "test@user.com",
        "first_name": "Test",
        "last_name": "Test",
        "address": {
          "zip_code": "1111",
          "street_name": "Calle",
          "street_numer": "120"
        },
        "identification": {
          "type": "DNI",
          "number": "88999000"
        }
      },
      "external_reference": "ext_ref_adv_paym",
      "description": "Advanced payment description",
      "binary_mode": false,
      "date_created": "2018-06-27T09:34:20.518-04:00",
      "date_last_updated": "2018-06-27T09:34:20.518-04:00",
      "metadata": {

      },
      "additional_info": {
        "items": [
          {
            "id": "item-ID-7356",
            "title": "Title of what you are paying for",
            "picture_url": "https://www.mercadopago.com/logomp3.gif",
            "description": "Item description",
            "category_id": "art",
            "quantity": 1,
            "unit_price": 100
          }
        ],
        "shipments": {
          "receiver_address": {
            "zip_code": "5700",
            "street_name": "Street",
            "street_number": 123,
            "floor": 4,
            "apartment": "C"
          }
        }
      }
    }
  ]
} 

Error Codes

CodeDescription
400 BAD_REQUEST
400004 Aplicação inválida.
400005 A aplicação é obrigatória.
400006 Data de liberação inválida para o Disbursement.
400007 Data de liberação inválida para o Disbursement.
400013 E-mail inválido.
400014 Número de pagamentos inválidos.
400015 ID do Payer é obrigatória para pagamentos com dinheiro em conta.
400016 Tipo de pagamento inválido.
400017 O valor da transação é obrigatório.
400018 Valor inválido.
400019 A forma de pagamento é obrigatória.
400020 O tipo de pagamento é obrigatório.
400021 O formato do valor é inválido.
400022 Modo de processamento inválido.
400023 O tipo de payer é obrigatório.
400024 O nome do payer é obrigatório.
400025 O sobrenome do payer é obrigatório.
400026 O tipo de identificação do payer é obrigatório.
400027 O número de identificação do payer é obrigatório.
400028 A data de vencimento é obrigatória.
400029 O token do pagamento é obrigatório.
400030 As parcelas são obrigatórias.
400031 O valor dos desembolsos é obrigatório.
400032 O ID do collector é obrigatório.
400033 Tarifa recolhida pelo Marketplace.
400034 Valor do desembolso inválido.
400035 O campo money_release_date é inválido.
400036 O Marketplace não tem permissões de acesso sobre o payer.
400037 O collector não foi encontrado.
400039 Request inválido.
400040 Status inválido.
400041 Data de início inválida.
400042 Data de fim inválida.
400043 E-mail inválido.
400044 ID do payer inválido.
400045 ID do collector inválido.
400046 O campo external_reference é inválido.
400047 Alguns parâmetros da busca são inválidos.
400048 ID inválido.
400049 Data da última modificação inválida.
400051 O campo money_release_date é obrigatório.
400052 O campo processing_mode é obrigatório.
400053 Conteúdo inválido.
400054 O Marketplace não possui permissões de acesso sobre o collector.
400055 O campo external_reference é obrigatório.
400056 O campo money_release_days é inválido.
400057 Os campos collector_id e external_reference estão duplicados.
400058 Chave de idempotência inválida.
401 UNAUTHORIZED
401000 Access token inválido.
401002 Access token inválido.
401003 Device token inválido.
404 NOT_FOUND
404001 O Disbusement não foi encontrado.
404002 O Advanced Payment não foi encontrado.
404003 O Payer não foi encontrado.
406 NOT_ACCEPTABLE
406001 Erro na API de payments.

Sua pesquisa não retorna resultados.

Check the spelling of search terms or test with other keywords.