Recursos para IA
Atualizar modo de operação do terminal

Este endpoint permite que você altere o modo de operação do terminal. Os terminals disponíveis para executar esta requisição serão: NEWLAND_N950, INGENICO_MOVE2500 e PAX_A910. Em caso de sucesso, a requisição retornará uma resposta com o status 200.

PATCH

https://api.mercadopago.com/terminals/v1/setup
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.
Body
terminals
array
Este nó contém o terminal cujo modo de operação você deseja modificar.
Response parameters
terminals
array
Este nó conterá as informações do terminal com seu novo modo de operação.
Erros

400Erro.

unsupported_site

Site inválido para fazer a solicitação. Os únicos locais/sites disponíveis são Argentina, Brasil, Chile e México. Verifique o Access Token enviado e tente executar a solicitação novamente.

unsupported_properties

Foi enviado um campo que não é suportado pela API. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.

required_properties

Algumas propriedades obrigatórias estão ausentes. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente enviando as informações faltantes.

property_value

Um valor inválido foi enviado para alguma propriedade. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.

invalid_payload

Payload inválido. Verifique os campos enviados e tente fazer a solicitação novamente.

401Erro.

unauthorized

O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.

403Sem permissão para acessar o recurso.

terminal_not_allowed_action

O terminal identificado no campo id não permite executar esta ação. Os únicos terminals habilitados para esta solicitação são PAX_A910 e NEWLAND_N950.

store_pos_not_found

O terminal utilizado não tem uma loja associada ou, caso haja uma loja, esta não tem um caixa criado. Revise a mensagem retornada e tente enviar a solicitação novamente.

404Erro.

not_found

Recurso não encontrado ou o valor enviado é inexistente. Valide as informações enviadas nos parâmetros e tente realizar a requisição novamente.

412Erro.

Only one pos-store with PDV mode ON or SUSPENDED is allowed

Operação não permitida porque já existe um terminal associado ao caixa e cada caixa permite apenas um associado em modo PDV.

500Erro.

internal_error

Erro interno. Revise a mensagem retornada e tente enviar a solicitação novamente.

Request
curl -X PATCH \
    'https://api.mercadopago.com/terminals/v1/setup'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    -d '{
  "terminals": [
    {
      "id": "NEWLAND_N950__SBX0000001",
      "operating_mode": "PDV"
    }
  ]
}'
Response
{
  "terminals": [
    {
      "id": "NEWLAND_N950__SBX0000001",
      "operating_mode": "PDV"
    }
  ]
}