# MD for: https://www.mercadopago.com.uy/developers/pt/docs/subscriptions/additional-content/payment-management.md

\# 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 curl -G -X GET \\ -H "accept: application/json" \\ "https://api.mercadopago.com/v1/payments/" \\ -d "access\_token=ACCESS\_TOKEN" \\ -d "status=approved" \\ -d "offset=0" \\ -d "limit=10"\` \`\`\` \`\`\`php <?php require ('mercadopago.php'); $mp = new MP ("ENV\_ACCESS\_TOKEN"); $payment = $mp->get( "/v1/payments/". $paymentId ); ?> \`\`\` Expected response: \`\`\`json { "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": "UYU", "description": "Telefono Celular iPhone 7", ..., } \`\`\` You can get information about all the returned variables in the \[API reference for the resource Payments\](https://www.mercadopago.com.uy/developers/en/reference/online-payments/checkout-api-payments/get-payment/get). ## Search payments If you want to search payments, you can use the \`Payment Search API\`: \`\`\`php <?php require ('mercadopago.php'); $mp = new MP ("ENV\_ACCESS\_TOKEN"); $payment = $mp->get( "/v1/payments/search", array( "external\_reference" => "123456789" ) ); ?> \`\`\` \`\`\`curl 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: \`\`\`json { "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 <?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 <?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.