Cadastrar uma loja

POST /partner/v2/{partnerId}/merchants cria a loja já pronta para uso: domínio padrão, formas de pagamento, áreas de entrega e assinatura em TRIAL por 10 dias, no plano padrão (standard) do parceiro.

O partnerId define a quem a loja pertence:

ID do parceiro: a loja é atendida diretamente pelo parceiro.
ID de uma revenda: a loja nasce na revenda (resaleId), abaixo do parceiro dela.

Um token de parceiro aceita o próprio ID e o de qualquer revenda dele. Um token de revenda aceita só o ID da revenda. Qualquer outro ID retorna 403. O ID do parceiro aparece em partnerId nas respostas de Listar lojas.

A loja recebe o plano marcado como standard do parceiro. Confira em Listar planos se existe um plano padrão disponível antes de cadastrar.

Corpo

string

obrigatório

Nome fantasia.

string

obrigatório

Razão social.

string

obrigatório

CNPJ ou CPF da loja, com ou sem formatação. Precisa ser válido.

string

obrigatório

E-mail da loja.

object

obrigatório

Responsável pela loja.

Mostrar propriedades

string

obrigatório

Nome.

string

obrigatório

E-mail.

string

obrigatório

Telefone.

string

CPF do responsável.

object

obrigatório

Endereço da loja. Todos os campos são obrigatórios.

Mostrar propriedades

string

obrigatório

CEP.

string

obrigatório

Rua.

string

obrigatório

Número.

string

obrigatório

Bairro.

string

obrigatório

Cidade.

string

obrigatório

UF.

Requisição

curl --request POST 'https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Cantina da Maria",
    "corporateName": "Cantina da Maria LTDA",
    "identifier": "11222333000144",
    "email": "contato@cantinadamaria.com.br",
    "personResponsible": {
      "name": "Maria Silva",
      "email": "maria@exemplo.com.br",
      "phone": { "number": "11999998888" },
      "identifier": "12345678909"
    },
    "address": {
      "postalCode": "01310-100",
      "street": "Avenida Paulista",
      "number": "1000",
      "district": "Bela Vista",
      "city": "São Paulo",
      "state": "SP"
    }
  }'

const response = await fetch(`https://api.deliveryvip.com.br/partner/v2/${partnerId}/merchants`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    name: 'Cantina da Maria',
    corporateName: 'Cantina da Maria LTDA',
    identifier: '11222333000144',
    email: 'contato@cantinadamaria.com.br',
    personResponsible: {
      name: 'Maria Silva',
      email: 'maria@exemplo.com.br',
      phone: { number: '11999998888' },
    },
    address: {
      postalCode: '01310-100',
      street: 'Avenida Paulista',
      number: '1000',
      district: 'Bela Vista',
      city: 'São Paulo',
      state: 'SP',
    },
  }),
})
const merchant = await response.json()

response = requests.post(
    f"https://api.deliveryvip.com.br/partner/v2/{partner_id}/merchants",
    headers={"Authorization": f"Bearer {token}"},
    json={
        "name": "Cantina da Maria",
        "corporateName": "Cantina da Maria LTDA",
        "identifier": "11222333000144",
        "email": "contato@cantinadamaria.com.br",
        "personResponsible": {
            "name": "Maria Silva",
            "email": "maria@exemplo.com.br",
            "phone": {"number": "11999998888"},
        },
        "address": {
            "postalCode": "01310-100",
            "street": "Avenida Paulista",
            "number": "1000",
            "district": "Bela Vista",
            "city": "São Paulo",
            "state": "SP",
        },
    },
)
merchant = response.json()

Respostas

Status	Quando
`201 Created`	Loja criada. O corpo é a loja completa, no formato de Obter detalhes.
`403 Forbidden`	`partnerId` fora do alcance do token.
`422 Unprocessable Content`	Dados inválidos. O `title` traz os erros por campo, com os nomes internos em snake_case.

Resposta (201, resumida)

{
  "id": "466caa37-ab0b-4f9d-b583-896681627367",
  "name": "Cantina da Maria",
  "identifier": "11.222.333/0001-44",
  "subscription": {
    "status": "TRIAL",
    "trialExpiresAt": "2025-10-10T17:35:03-03:00",
    "planId": "aa67c98c-d81f-5a9c-b0bc-26caa0051aea"
  },
  "partnerId": "32eeaefa-6a31-487f-9402-fd9a41683830"
}

Visão geral

Lojas

Revendas

Planos

Faturas

Cadastro

Referência

Corpo

Requisição

Respostas

Próximos passos

Adicionar membros

Ativar a assinatura

​Corpo

​Requisição

​Respostas

​Próximos passos

Adicionar membros

Ativar a assinatura

Corpo

Requisição

Respostas

Próximos passos