| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
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 conciliadora 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émusernameepasswordnecessários para gerar o token de acesso e, por conseguinte, solicitar o arquivo de conciliação.
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
usernameepasswordgerados, essa informação é recebida exclusivamente pelo integrador em suawebhookUrle 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.
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.