---
title: "Pedido de consentimento"
url: "https://devcenter.stone.com.br/conciliacao-pedido-de-consentimento"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Pedido+de+consentimento,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9jb25jaWxpYWNhby1wZWRpZG8tZGUtY29uc2VudGltZW50byI,s_LCmX4SU5qnQlbTAW.png"
---

# Pedido de consentimento

## [Endpoint](#endpoint)

```text
POST https://conciliation.stone.com.br/v2/merchant/consents
```

### [Corpo da requisição](#corpo-da-requisição)

| Campo           | Tipo   | Obrigatório | Descrição                                                 |
| :-------------- | :----- | :---------- | :-------------------------------------------------------- |
| clientId        | string | sim         |                                                           |
| clientSecret    | string | sim         |                                                           |
| document        | string | sim         |                                                           |
| affiliationCode | string | não         | (Obrigatório somente para clientes que possuem StoneCode) |
| webhookUrl      | string | sim         |                                                           |

O resultado será informado através do código de status HTTP da resposta.

| HTTP Status Code | Descrição                                                                        |
| :--------------- | :------------------------------------------------------------------------------- |
| 201              | Pedido de consentimento criado. O e-mail de solicitação foi enviado para o lojista, para que ele conceda o acesso ou não. |
| 400              | Erro nos dados informados para a API                                             |
| 404              | Erro no formato da URL ou no método enviado                                      |
| 500              | Ocorreu um erro interno na API, por favor nos informe                            |
| 503              | Um dos sistemas da Stone falhou, por favor nos informe                           |
| 504              | Ocorreu um timeout e não foi possível concluir o trabalho, tente novamente       |

Após o envio da requisição, a Stone enviará um **evento de consentimento** para a `webhookUrl` informada.

-   Inicialmente, o status do evento será `pending`, indicando que o pedido de consentimento está aguardando a decisão do lojista.
-   Se o lojista recusar o pedido, um novo evento será enviado com o status `denied`.
-   Caso o lojista aprove o consentimento, o status será `accepted`. Neste caso, o payload do evento incluirá também`username` e `password` necessários para gerar o token de acesso e, por conseguinte, solicitar o arquivo de conciliação.

Autenticação por documento

Esse fluxo garante que o acesso ao arquivo de conciliação só será liberado após a aprovação explícita do lojista responsável pelo documento informado.

No caso de extração por Stone Code, o Stone Code utilizado deve estar vinculado ao mesmo documento para o qual o consentimento foi solicitado.

**A autorização é concedida para o documento**, ou seja, um mesmo par de `username` e `client_id`, e posteriormente um token de acesso, devem ser utilizados para extração do arquivo de todos os Stone Codes associados a esse documento.

O recomendado é a utilização mesma URL de webhook para receber as credenciais de todos os lojistas. Caso exista a necessidade de utilizar URLs diferentes, será necessário aguardar **10 minutos**, pois existe um **cache por clientId** que não permitirá o envio para a nova URL antes desse prazo.

Não armazenamos os `username`e `password` gerados, essa informação é recebida exclusivamente pelo integrador em sua `webhookUrl` e devem ser armazenados pelo mesmo. Em caso de perda dessas informações, não é possível recuperá-las. Para obter novas credenciais, será necessário realizar um novo pedido de consentimento. Após a aprovação do lojista, as credenciais serão entregues novamente via webhook.

Devido a uma atualização na infraestrutura Stone, credenciamentos criados a partir de setembro de 2026 começaram a ter **novos identificadores**, deixando de possuir um StoneCode (affiliationCode). 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.

**O parâmetro** `affiliationCode` **continua sendo obrigatório somente para clientes que possuem StoneCode, caso contrário, basta passar o documento.**  
Caso seu cliente possua um StoneCode e ele não seja passado como parâmetro, será retornado o erro "AffiliationCode is required for this merchant".

---

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

[**Próxima etapa**Resposta de Consentimento](https://devcenter.stone.com.br/conciliacao-resposta-de-consentimento)

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.