Criar Terminal

Registra um novo terminal na plataforma. O terminal é identificado pelo número de série (serialNumber) e associado a um lojista pelo merchantId.

Na primeira chamada, a API retorna um código de verificação de 6 dígitos (verificationCode) que deve ser inserido no terminal para concluir o provisionamento.

Endpoint

POST/v1/terminals

Request

{
  "merchantId": "d6uo5nc42nrc73gv867g",
  "serialNumber": "SN123456"
}

Parâmetros do Corpo

Campo	Tipo	Obrigatório	Descrição
merchantId	string	✓	ID do lojista ao qual o terminal será associado
serialNumber	string	✓	Número de série do terminal (máx. 20 caracteres, convertido para maiúsculas)

Response

{
  "id": "d59gpddc93gc73jvje0g",
  "serialNumber": "SN123456",
  "verificationCode": "482951",
  "verificationCodeExpiresAt": "2026-05-06T11:30:00Z"
}

Campos da Resposta

Campo	Tipo	Descrição
id	string	ID único do terminal
serialNumber	string	Número de série normalizado
verificationCode	string	Código de 6 dígitos para provisionamento
verificationCodeExpiresAt	string	Data/hora de expiração do código (ISO 8601)