Received payments management

You can find any information about generated payments using our APIs.

Get created payments using your ID

To get information about a payment using your ID, you need to make the following request:

curl -G -X GET \
-H "accept: application/json" \
"https://api.mercadopago.com/v1/payments/<payment_id>" \
-d "access_token=ACCESS_TOKEN" \
-d "status=approved" \
-d "offset=0" \
-d "limit=10"`

<?php
    require ('mercadopago.php');

    $mp = new MP ("ENV_ACCESS_TOKEN");

    $payment = $mp->get(
        "/v1/payments/". $paymentId
    );
?>

Expected response:

{
  "id": 2798247250,
  "date_created": "2017-06-16T21:10:06.000-04:00",
  "date_approved": "2017-06-16T21:10:06.000-04:00",
  "date_last_updated": "2017-06-28T19:39:41.000-04:00",
  "date_of_expiration": null,
  "money_release_date": "2017-06-21T21:10:06.000-04:00",
  "operation_type": "regular_payment",
  "payment_method_id": "visa",
  "payment_type_id": "credit_card",
  "status": "approved",
  "status_detail": "accredited",
  "currency_id": "COP",
  "description": "Telefono Celular iPhone 7",
  ...,
}

You can get information about all the returned variables in the API reference for the resource Payments.

Search payments

If you want to search payments, you can use the Payment Search API:

<?php
    require ('mercadopago.php');

    $mp = new MP ("ENV_ACCESS_TOKEN");

    $payment = $mp->get(
        "/v1/payments/search",
        array(
            "external_reference" => "123456789"
        )
    );
?>

curl -G -X GET \
-H "accept: application/json" \
-H 'Authorization: Bearer ACCESS_TOKEN' \
"https://api.mercadopago.com/v1/payments/search" \
-d "status=approved" \
-d "offset=0" \
-d "limit=10"

In this example, your search is done through the field external_reference, but it is possible to use many other filters.

Search filters

When searching for payments, the following variables may be applied:

payer.id: : Buyer’s identification.
installments: Number of installments (example: 12).
payment_method_id: Payment method (e.g.: visa).
payment_type_id: Type of payment method (e.g.:credit_card).
operation_type: The type of operation, which may regular_payment, pos_payment, recurring_payment, etc.
processing_mode: If the payment is Gateway or Aggregator (example: gateway).
status: Payment status.
status_detail: Detail of the payment status.

The total number of results will be displayed, which can then be used for pagination:

{
  "paging": {
    "total": 1234,
    "limit": 30,
    "offset": 0
  },
  "results": [
    {}
  ]
}

Filter search results by date

It is also possible to search setting specific dates:

begin_date: Start date of the search (ISO 8601), eg. 2017-05-06T15:07:20.000-04:00.
end_date: End date of the search (ISO 8601), eg. 2017-05-06T15:07:20.000-04:00.

Date fields also support the NOW variable combined with the following variables:

MINUTES: Minutes (1 to 60).
HOURS: Hours (1 to 24).
WEEKS: Weeks (1 to 8).
DAYS: Days (1 to 365).

For example NOW-5MINUTES:

<?php
    require ('mercadopago.php');

    $mp = new MP ("ENV_ACCESS_TOKEN");

    $payment = $mp->get(
        "/v1/payments/search",
        array(
            "begin_date" => "NOW-2HOURS",
            "end_date" => "NOW",
            "range" => "date_last_updated",
            "sort" => "date_last_updated",
            "criteria" => "desc"
        )
    );
?>

This example shows all payments updated in the last 2 hours up to the current date, in descending order.

You can use the range field to search a specific date field, e.g. date_created or date_last_updated.

Payments pagination

If you have too many results, you must page the payments using the following attributes:

Attribute	Description	Example
`limit`	Number of results shown (max value = 50). If it is not defined, it will return up to 30 results found.	`limit=50`
`offset`	Position from which you want the results to be returned. By default, the value is 0 (max. allowed: 10000).	`offset=100`
`sort`	It sets a criterion to sort the results.	`sort=external_reference`
`criteria`	Order of information. It may be asc (ascending) or desc (descending).	`criteria=asc`

Example of pagination:

<?php
    require ('mercadopago.php');

    $mp = new MP ("ENV_ACCESS_TOKEN");

    $payment = $mp->get(
        "/v1/payments/search",
        array(
            "external_reference" => "123456789",
            "limit" => 50,
            "offset" => 200,
            "sort" => "id",
            "criteria" => "desc"
        )
    );
?>

This would display 50 results, filtering the first 200, and sorting them by id in descending order.

Was this information helpful?

Yes

Thank you for helping us improve. We’re sorry you didn’t find what you were looking for. Could you give us more details? It will only take a few minutes. Go to the form.

For help, you can review the frequently asked questions or speak with us through the support

Thank you for helping us improve! Can you tell us about your experience?
It will only take a few minutes. Go to the form.