Recursos para IA
Enviar documentação comprobatória

Este endpoint permite enviar arquivos de documentação comprobatória relacionados a um caso de contestação. Tipos de arquivo suportados: image/jpeg, image/png e application/pdf. Antes de enviar a documentação, consulte GET /v1/chargebacks/{id} para confirmar que documentation_status=pending, já que a documentação só pode ser enviada uma vez por caso. Em caso de sucesso, a requisição retornará uma resposta com status 200.

POST

https://api.mercadopago.com/v1/chargebacks/{id}/documentation
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
X-Caller-Id
integer

OBRIGATÓRIO

ID do usuário autenticado (seller ID) e proprietário do recurso solicitado.
Path
id
string

OBRIGATÓRIO

O case_id numérico do caso de contestação ao qual a documentação comprobatória será enviada.
Response parameters
type
string
Responsável pelo envio da documentação comprobatória. O único valor permitido é collector, utilizado para arquivos enviados pelo vendedor.
collector: Único valor permitido. Identifica os arquivos de documentação comprobatória enviados pelo vendedor.
url
string
URL para acessar ou visualizar o arquivo comprobatório.
description
string
Texto descritivo que identifica o tipo de evidência do arquivo comprobatório. Por exemplo: Nota Fiscal, comprovante de envio, captura de tela, etc.
uuid
string
Identificador único do arquivo comprobatório. É utilizado como o parâmetro uuid no endpoint GET /v1/chargebacks/documentation/{type}/{uuid} para baixar ou renderizar o arquivo.
Erros

400Erro de requisição.

missing_required_params

O case_id da contestação ou o parâmetro X-Caller-Id estão ausentes. Reenvie a solicitação com as informações necessárias.

missing_files

Nenhum arquivo comprobatório foi enviado na solicitação. Reenvie a solicitação incluindo os arquivos necessários.

empty_file

O arquivo comprobatório enviado está vazio. Reenvie a solicitação corretamente com os devidos arquivos.

documentation_already_submitted

O caso já tem documentação comprobatória enviada (documentation_status não é pending). Envie uma solicitação ao endpoint de busca (GET /v1/chargebacks/{id}) para verificar o arquivo comprobatório que já foi submetido.

403Acesso negado.

invalid_user_for_operation

O solicitante não tem permissão para acessar o recurso solicitado (não é o proprietário do caso ou do arquivo comprobatório).

413Payload muito grande.

too_many_files

Foram enviados mais de 10 arquivos comprobatórios, excedendo o limite permitido.

file_size_exceeded

O tamanho total do arquivo comprobatório excede 10 MB, ultrapassando o limite permitido.

415Tipo de arquivo não suportado.

unsupported_file_type

O formato do arquivo comprobatório é inválido, sendo suportados apenas arquivos JPEG, PNG e PDF.

500Erro genérico.

internal_error

Ocorreu um erro genérico. Verifique a solicitação e tente novamente.

Request
curl -X POST \
    'https://api.mercadopago.com/v1/chargebacks/{id}/documentation'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
       -H 'X-Caller-Id: 123456789' \
    
Response
[
  {
    "type": "collector",
    "url": "https://storage.mlstatic.com/op/123/456789/comprobante.pdf",
    "description": "Chargeback 1",
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
]