---
title: "Consulta de identificadores do lojista"
url: "https://devcenter.stone.com.br/conciliacao-consulta-de-identificadores-do-lojista"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Consulta+de+identificadores+do+lojista,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9jb25jaWxpYWNhby1jb25zdWx0YS1kZS1pZGVudGlmaWNhZG9yZXMtZG8tbG9qaXN0YSI,s_hekG8E7I1Uho6Itz.png"
---

# Consulta de identificadores do lojista

## [Endpoint](#endpoint)

```text
GET https://conciliation.stone.com.br/v2/merchant/identifiers
```

### [Query params](#query-params)

| Nome     | Obrigatório | Tipo   | Descrição                                                                        |
| :------- | :---------- | :----- | :------------------------------------------------------------------------------- |
| document | sim         | string | CPF (11 caracteres) ou CNPJ (14 caracteres), sem máscara (apenas letras e dígitos). |

### [Headers](#headers)

| Nome          | Obrigatório | Tipo   | Descrição                  |
| :------------ | :---------- | :----- | :------------------------- |
| Authorization | sim         | string | (padrão: Bearer <JWT>)     |
| Accept        | sim         | string | (padrão: application/json) |

Novos identificadores

A partir de **Setembro de 2026**, credenciamentos criados na Stone passaram a contar com **novos identificadores**, que substituem o Stonecode no processo de conciliação. Essa atualização está sendo aplicada de forma **gradual**: durante o período de transição, alguns estabelecimentos ainda podem ser credenciados no modelo anterior. Para viabilizar a conciliação nesse cenário, disponibilizamos este endpoint, que permite **consultar os novos identificadores do estabelecimento a partir do CNPJ consentido**. Com eles, você extrai os arquivos de conciliação seguindo o fluxo do [**NOVO Extrato da Agenda Stone**](https://devcenter.stone.com.br/conciliacao-novo-extrato-agenda-stone).

## [Quando usar](#quando-usar)

-   **Estabelecimentos com os novos identificadores** (não possui Stonecode) — use esta consulta, informando o documento, para obter os identificadores e utilizá-los na extração.
-   **Estabelecimentos no modelo anterior** — a extração continua sendo feita pelo StoneCode, como sempre.

Mesmo formato

Não é necessária nenhuma mudança estrutural na sua integração: o arquivo de conciliação mantém o mesmo formato e o mesmo conteúdo. O que muda é apenas por qual identificador você solicita o arquivo.

## [Como funciona](#como-funciona)

1.  Você faz a consulta informando o documento (CPF ou CNPJ) do estabelecimento que o cliente consentiu.
2.  O endpoint retorna a lista de identificadores associados àquele documento.
3.  Você utiliza esses identificadores na extração dos arquivos de conciliação.

## [Autenticação](#autenticação)

É feita passando o [token de acesso](https://devcenter.stone.com.br/conciliacao-gerando-seu-token-de-acesso) no header `Authorization: Bearer TOKEN`.

O documento informado em `document` precisa ser o mesmo documento para o qual o token de acesso foi gerado (obtido por meio do [consentimento](https://devcenter.stone.com.br/conciliacao-consulta-de-status-de-consentimento)). Se o token for de outro documento, a requisição é recusada com 403.

## [Regras de comportamento](#regras-de-comportamento)

Documento válido que possua **apenas** credenciamentos no modelo anterior (por Stonecode) retorna **200 com lista vazia (\[\])** — isso não é um erro.

Documento existente, sem credenciamentos no modelo novo:

```json
[]
```

## [Códigos de status](#códigos-de-status)

-   **200 OK** — Lista de identificadores retornada (pode ser vazia).
-   **400 Bad Request** — Falha de validação da requisição. Retorna a lista de erros por campo.
-   **401 Unauthorized** — Token ausente, malformado ou inválido.
-   **403 Forbidden** — Claim `custom:document` do token diferente do document informado na query.
-   **404 Not Found** — Documento não encontrado na base de estabelecimentos.
-   **429 Too Many Requests** — Limite de chamadas excedido (ver Rate limit).
-   **503 Service Unavailable** — Indisponibilidade momentânea do serviço. Aguarde e repita a chamada mais tarde.

## [Rate limit](#rate-limit)

A rota possui limite de 4 chamadas por hora, considerando a URL completa, ou seja, 4 requisições por documento. Ao exceder o limite, a resposta é 429.

Como os identificadores mudam com pouca frequência, recomendamos aplicar cache local no seu fluxo em vez de consultar a cada extração. Isso evita consumir o limite sem necessidade.

---

**Jornada: [Obter o consentimento e autenticar](https://devcenter.stone.com.br/conciliacao-pedido-de-consentimento)**  
Etapa 5 de 6

[**Etapa anterior**Consulta de status de consentimento](https://devcenter.stone.com.br/conciliacao-consulta-de-status-de-consentimento)[**Próxima etapa**Gerando seu token de acesso](https://devcenter.stone.com.br/conciliacao-gerando-seu-token-de-acesso)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.