API atual/Referência completa/App do vendedor (mobile)

Notificações

Lista as notificações do usuário logado, da mais nova para a mais antiga.

Devolve os avisos de pedido, pagamento, repasse e sistema destinados ao usuário do token (não ao seller inteiro). O texto longo é omitido para economizar dados: o app mostra o assunto.

GET/api/v1/vendor/mobile/notificationsSeller

Notificações do usuário

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário do painel do seller (lojista), obtido no login (veja Tokens).

Parâmetros de consulta

pageintegerpadrão: 1

Página, a partir de 1.

per_pageintegerpadrão: 20

Itens por página. Padrão 20, máximo 50.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/mobile/notifications?per_page=20" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Notificações

json

{
  "notifications": [
    {
      "id": "a2c1f0de-1b7e-4d26-9f8c-3a6d5e4b7c10",
      "type": "order",
      "subject": "Novo pedido PEDIDO-20261010-0004",
      "status": "unread",
      "created_at": "2026-10-10T14:22:07Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Campos da resposta

notificationsarray

Notificações da página.

notifications[].iduuid

Id da notificação.

notifications[].typestring

Categoria, por exemplo order, payment, vendor, system.

notifications[].subjectstring

Título da notificação.

notifications[].statusstring

unreadread

unread ou read.

notifications[].created_atstring

RFC 3339.

totalinteger

Notificações do usuário.

pageinteger

Página.

per_pageinteger

Itens por página.

Erros

Status	Quando	Corpo
401	Sem token ou token inválido/expirado.	`{"error":"missing authorization header"}` / `{"error":"invalid or expired token"}`
403	O token não é de um usuário seller (por exemplo, é de um administrador da loja).	`{"error":"insufficient permissions"}`
403	O cadastro do seller ainda está em análise (só a tela de cadastro funciona até a aprovação).	`{"error":"vendor_pending_review","message":"..."}`
500	Falha ao consultar.	`{"error":"failed to get notifications"}`