Recursos para IA
Reclamações
A API de Reclamações permite gerenciar o ciclo de vida das disputas e reclamações entre compradores e vendedores. Esta referência descreve os endpoints disponíveis e como interagir com eles.
Endpoints disponíveis
Todos os endpoints que compõem a integração com Reclamações.
| Operação | Path | Descrição |
| Obter detalhes da reclamaçãoGET | /post-purchase/v1/claims/{claim_id} | Retorna os detalhes de uma reclamação, como os usuários envolvidos, o recurso afetado, o status atual e o tipo de reclamação. |
| Buscar reclamaçõesGET | /post-purchase/v1/claims/search | Busca reclamações por filtros como status, tipo ou resource_id, retornando resultados paginados. |
| Obter motivo da reclamaçãoGET | /post-purchase/v1/claims/reasons/{reason_id} | Retorna o motivo associado a um reason_id, incluindo sub-motivos e sua hierarquia. |
| Obter histórico da reclamaçãoGET | /post-purchase/v1/claims/{claim_id}/status_history | Retorna o histórico de status e ações pelos quais uma reclamação passou desde sua abertura. |
| Obter evidências da reclamaçãoGET | /post-purchase/v1/claims/{claim_id}/evidences | Lista as evidências carregadas para uma reclamação, indicando o seu tipo, o status e a data de carregamento. |
| Obter notificações da reclamaçãoGET | /claim_resource | Obtém as notificações de uma reclamação a partir do campo resource, recebido em uma notificação webhook. |
| Operação | Path | Descrição |
| Obter mensagens da reclamaçãoGET | /post-purchase/v1/claims/{claim_id}/messages | Lista as mensagens trocadas entre as partes de uma reclamação, com autor, data e conteúdo. |
| Obter informações do arquivoGET | /post-purchase/v1/claims/{claim_id}/attachments/{fileName} | Retorna os metadados de um arquivo anexado, como nome, tipo e status de moderação. |
| Baixar arquivos anexadosGET | /post-purchase/v1/claims/{claim_id}/attachments/{fileName}/download | Faz o download do conteúdo binário de um arquivo anexado a uma reclamação. |
| Anexar arquivos à mensagemPOST | /post-purchase/v1/claims/{claim_id}/attachments | Envia um ou mais arquivos anexados a uma reclamação para respaldar a posição de uma das partes. |
| Enviar mensagem com arquivoPOST | /post-purchase/v1/claims/{claim_id}/actions/send-message | Envia uma mensagem com arquivos anexados para o histórico de comunicação de uma reclamação. |
| Operação | Path | Descrição |
| Solicitar mediação da reclamaçãoPOST | /post-purchase/v1/claims/{claim_id}/actions/open-dispute | Escala uma reclamação para mediação do Mercado Pago quando as partes não chegam a um acordo direto. |
| Ver resoluções esperadas em mediaçãoGET | /post-purchase/v1/claims/{claim_id}/expected-resolutions | Lista as possíveis resoluções que o Mercado Pago pode aplicar ao encerrar a mediação de uma reclamação. |
| Operação | Path | Descrição |
| Carregar evidências de envioPOST | /post-purchase/v1/claims/{claim_id}/actions/evidences | Carrega evidências de envio (número de rastreamento, etiqueta ou outros comprovantes) para respaldar o vendedor em uma reclamação. |
Tudo pronto para começar?
Acesse o primeiro endpoint e comece a gerenciar reclamações.