Gerenciar apps autorizados nas lojas

Em vez de pedir ao lojista que autorize um app no painel, o parceiro pode autorizar direto pela API. É assim que você instala, por exemplo, o PDV parceiro em todas as lojas novas.

Ação	Endpoint	Sucesso
Adicionar permissão	`POST /partner/v2/merchants/{merchantId}/applications`	`202`
Remover permissão	`DELETE /partner/v2/merchants/{merchantId}/applications/{applicationId}`	`202`

Adicionar Permissão

uuid

obrigatório

ID do app a autorizar. O app precisa ser de distribuição direta.

curl --request POST 'https://api.deliveryvip.com.br/partner/v2/merchants/{merchantId}/applications' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{ "permission": { "applicationId": "161be0be-38d1-44a0-84ea-161093886253" } }'

await fetch(`https://api.deliveryvip.com.br/partner/v2/merchants/${merchantId}/applications`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ permission: { applicationId } }),
})

requests.post(
    f"https://api.deliveryvip.com.br/partner/v2/merchants/{merchant_id}/applications",
    headers={"Authorization": f"Bearer {token}"},
    json={"permission": {"applicationId": application_id}},
)

Resposta (202)

{ "applicationId": "161be0be-38d1-44a0-84ea-161093886253" }

Os scopes não são escolhidos na chamada: a loja recebe os scopes que o app declara, limitados a od.all e dv.loyalty. Um campo scopes no corpo é ignorado. Chamar de novo para um app já autorizado não cria uma segunda permissão.

Status	Quando
`404 Not Found`	App ou loja não encontrados.
`422 Unprocessable Content`	`application_must_be_manual_type`: o app é de distribuição interativa; ou `permission_failed`.

Remover Permissão

Revoga todos os tokens do app para essa loja. A integração deixa de acessar a loja na hora.

curl --request DELETE 'https://api.deliveryvip.com.br/partner/v2/merchants/{merchantId}/applications/{applicationId}' \
  --header 'Authorization: Bearer {token}'

await fetch(`https://api.deliveryvip.com.br/partner/v2/merchants/${merchantId}/applications/${applicationId}`, {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${token}` },
})

requests.delete(
    f"https://api.deliveryvip.com.br/partner/v2/merchants/{merchant_id}/applications/{application_id}",
    headers={"Authorization": f"Bearer {token}"},
)

Responde 202 com o applicationId, ou 404 se o app não está autorizado na loja.

Visão geral

Lojas

Revendas

Planos

Faturas

Cadastro

Referência

Adicionar Permissão

Remover Permissão

​Adicionar Permissão

​Remover Permissão

Adicionar Permissão

Remover Permissão