Skip to main content
GET
Listar merchants
Esta rota é o ponto de partida da integração: ela retorna os estabelecimentos (merchants) que autorizaram a sua aplicação — o escopo completo do token. O vínculo nasce quando o estabelecimento ativa a integração no painel da Repediu; quando ele desativa, o merchant sai do escopo e os dados dele deixam de aparecer em todas as rotas. O id de cada merchant é o UUID que você usará no restante da API:

Obter merchant

É o merchantId do detalhe do estabelecimento.

Pedidos e clientes

É o mesmo valor de storeId nos pedidos e de merchantId nos clientes.

CRM do parceiro e métricas

É o merchantId do caminho de todas as rotas /v1/stores/{merchantId}/....
O envelope desta rota é aninhado: a lista vem em merchants e a paginação num objeto pagination separado — diferente das rotas de clientes e pedidos, que usam envelope plano (items, page, pageSize, total no mesmo nível).
pageSize padrão é 50 e o máximo é 200 — valores maiores são reduzidos para 200 silenciosamente (não geram erro).

Status do merchant

Erros

Autorizações

Authorization
string
header
obrigatório

Token de acesso emitido por POST /od/v2/oauth/token (fluxo client_credentials). Envie no header Authorization como Bearer <token>.

Parâmetros de consulta

page
integer<int32>
padrão:1

Página, iniciando em 1.

pageSize
integer<int32>
padrão:50

Itens por página. Valores acima de 200 são limitados a 200.

Intervalo obrigatório: x <= 200
status
enum<string>

Filtra pelo status do merchant.

Opções disponíveis:
OPEN,
CLOSED,
PAUSED

Resposta

Lista de merchants do escopo da aplicação.

merchants
object[]
pagination
object