Recursos para IA
Excluir caixa

Este endpoint permite a exclusão de um caixa (ponto de venda) específico, identificado pelo seu ID. O caixa deve pertencer ao usuário do Access Token. Em caso de sucesso, a requisição retornará uma resposta com o status 204 sem body. Se a mesma requisição for reenviada com o mesmo X-Idempotency-Key (primeira chamada bem-sucedida — 204), a segunda chamada retornará 200.

DELETE

https://api.mercadopago.com/v2/pos/{pos_id}
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-Idempotency-Key
string

OBRIGATÓRIO

Esta função permite repetir solicitações de forma segura, sem o risco de realizar a mesma ação mais de uma vez por engano. Isso é útil para evitar erros, como a exclusão de um caixa duas vezes. Para garantir que cada sol
Path
pos_id
string

OBRIGATÓRIO

Identificador numérico do caixa a ser excluído, atribuído automaticamente pelo Mercado Pago no momento da criação. Deve ser um número inteiro maior ou igual a 0.
Response parameters
This request has no response
Erros

400Requisição inválida

resource_bad_request_error

O pos_id fornecido no path não é um integer válido ou é negativo. Verifique se o valor é um integer base-10 não negativo.

bad_request

A requisição não pôde ser processada. Verifique se o caixa pertence ao usuário do Access Token e se o header X-Idempotency-Key está presente e não está vazio.

idempotency_key_already_used

O valor do X-Idempotency-Key enviado já foi utilizado em uma requisição anterior com um payload diferente. Gere um novo valor único para cada operação distinta.

401Não autorizado

unauthorized

O valor enviado como Access Token está incorreto ou ausente. Verifique e tente novamente com um Access Token válido.

404Não encontrado

pos_not_found

Nenhum caixa foi encontrado para o pos_id fornecido e o usuário do Access Token. Verifique se o ID está correto e pertence à sua conta.

409Conflito

conflict

A mesma requisição já está sendo processada por outra chamada concorrente com o mesmo X-Idempotency-Key. Aguarde alguns segundos e tente novamente com a mesma chave e o mesmo payload.

500Erro interno do servidor

internal_server_error

Ocorreu um erro inesperado no servidor. Trata-se de uma falha transitória não relacionada aos dados da requisição. Tente novamente após alguns instantes.

Request
curl -X DELETE \
    'https://api.mercadopago.com/v2/pos/{pos_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
       -H 'X-Idempotency-Key: ecd780c5-bbbb-4afa-bd8a-4753fc9338f2' \
    
Response
// Esta requisição não tem resposta.