Atualizar Lojista

Atualize as informações de um comerciante existente.

Endpoint

PUT/v1/merchants/{merchantId}

Request

{
  "dbaName": "Coffee Shop Faria Lima",
  "corporateName": "Coffee Shop Comércio LTDA",
  "taxId": "12345678000190",
  "address": {
    "postalCode": "01452000",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Itaim Bibi",
    "street": "Av. Faria Lima",
    "number": "3000",
    "complement": "Andar 10",
    "country": "BR"
  },
  "contact": {
    "site": "http://coffeeshop.com",
    "email": "faria-lima@coffeeshop.com",
    "phone": "+5511999999999"
  }
}

Parâmetros de Path

Parâmetro	Tipo	Obrigatório	Descrição
merchantId	string	✓	ID único do lojista

Corpo da Requisição

Todos os campos são opcionais — envie apenas os que quer alterar. Ao enviar address, informe o objeto completo (ele substitui o anterior por inteiro).

Campo	Tipo	Descrição
dbaName	string	Nome comercial
corporateName	string	Razão social
taxId	string	CNPJ ou CPF
address	object	Endereço comercial (ver tabela abaixo)
contact	object	Informações de contato (site, email, phone)

Objeto Address

Campo	Tipo	Obrigatório¹	Descrição
postalCode	string	✓	CEP (8 dígitos, sem hífen)
state	string	✓	Código do estado (2 letras)
city	string	✓	Cidade
neighborhood	string	✓	Bairro / distrito
street	string	✓	Nome da rua
number	string	✓	Número da rua
country	string	—	Código do país (ISO 3166-1 alpha-2, ex.: BR)
complement	string	—	Informação adicional (apartamento, sala, etc.)

¹ Obrigatório apenas quando o objeto address é enviado.

Response

{
  "id": "d6uo5nc42nrc73gv867g",
  "createdAt": "2026-03-20T10:00:00Z",
  "updatedAt": "2026-03-20T11:15:00Z",
  "type": "merchant",
  "dbaName": "Coffee Shop Faria Lima",
  "corporateName": "Coffee Shop Comércio LTDA",
  "taxId": "12345678000190",
  "parentId": "d59gpddc93gc73jvje0g",
  "merchantCategoryCode": "5347",
  "economicActivityCode": "4712100",
  "address": {
    "id": "d6uo5nc42nrc73gv8680",
    "postalCode": "01452000",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Itaim Bibi",
    "street": "Av. Faria Lima",
    "number": "3000",
    "complement": "Andar 10",
    "country": "BR"
  },
  "contact": {
    "id": "d6uo5nc42nrc73gv8681",
    "site": "http://coffeeshop.com",
    "email": "faria-lima@coffeeshop.com",
    "phone": "+5511999999999"
  },
  "bankAccounts": [
    {
      "id": "d6uo5nc42nrc73gv8682",
      "accountType": "checking",
      "routingNumber": "0001",
      "accountNumber": "12345678-9"
    }
  ],
  "contactPerson": [
    {
      "id": "d6uo5nc42nrc73gv8683",
      "name": "João Silva",
      "taxId": "12345678900",
      "email": "joao@coffeeshop.com",
      "phone": "+5511988888888",
      "position": "Gerente"
    }
  ]
}

Campos da Resposta

Retorna o objeto completo e atualizado do lojista — mesma estrutura descrita em Criar Lojista. bankAccounts e contactPerson são retornados por completo, mas não podem ser alterados por este endpoint.