Recursos para IA
Buscar contracargos

Este endpoint permite buscar todos los casos de contracargo asociados a un payment_id, retornado a partir de una notificación configurada para el tópico de chargebacks. El solicitante deberá ser el vendedor del pago consultado y la respuesta incluirá paginación y los detalles completos de cada caso encontrado, incluido el status de la documentación probatoria. En caso de éxito, la solicitud devolverá una respuesta con status 200.

GET

https://api.mercadopago.com/v1/chargebacks/search
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
X-Caller-Id
integer

REQUERIDO

ID del usuario autenticado (seller ID) y propietario del recurso solicitado.
Query
payment_id
integer

REQUERIDO

ID del pago para el que se desea buscar casos de contracargo, obtenido de una notificación configurada para el tópico chargebacks.
offset
integer
Número de resultados a omitir para la paginación. El valor mínimo y predeterminado es 0.
limit
integer
Número de resultados por página. El valor mínimo es 1 y el valor predeterminado es 10.
Response parameters
paging
object
Metadatos de paginación.
results
array
Lista de casos de contracargo encontrados.
Errores

400Error de solicitud.

invalid_payment_id

El parámetro payment_id está ausente o es inválido. Consulta la notificación recibida para el tópico chargebacks para obtener el ID correcto.

403Acceso denegado.

unauthorized_payment_access

El solicitante no está autorizado para consultar el pago indicado. Solo la cuenta vendedora asociada al pago puede realizar esta consulta.

500Error genérico.

internal_error

Ocurrió un error genérico. Verifica la solicitud e inténtalo nuevamente.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/chargebacks/search?payment_id=987654321&limit=10'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
       -H 'X-Caller-Id: 123456789' \
    
Response
{
  "paging": {
    "offset": 0,
    "limit": 10,
    "total": 1
  },
  "results": [
    {
      "id": "123456789",
      "payments": [
        {}
      ],
      "currency": "ARS",
      "amount": "50.00",
      "reason": "unauthorized",
      "reason_id": "6",
      "coverage_applied": true,
      "coverage_eligible": true,
      "documentation_required": true,
      "documentation_status": "pending",
      "documentation": [
        {
          "type": "collector",
          "url": "https://storage.mlstatic.com/op/123/456789/comprobante.pdf",
          "description": "Comprobante de envío",
          "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
        }
      ],
      "date_documentation_deadline": "2024-02-15T23:59:59.000-03:00",
      "date_created": "2024-02-01T10:30:00.000-03:00",
      "date_last_updated": "2024-02-03T14:00:00.000-03:00",
      "live_mode": true
    }
  ]
}