Atualizar Lojista
Atualize as informações de um comerciante existente.
Endpoint
PUT
/v1/merchants/{merchantId}Parâmetros de Path
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
merchantId | string | ✓ | ID único do lojista |
Corpo da Requisição
Os campos abaixo podem ser enviados individualmente ou em conjunto — apenas os campos presentes serão atualizados.
| 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.) |
Request
curl -X PUT https://yby-dev.positivolabs.com.br/v1/merchants/{merchantId} \
-H "Authorization: Bearer <accessToken>" \
-H "Content-Type: application/json" \
-d '{
"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"
}
}'
Resposta
{
"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"
}
]
}