| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
É necessário cadastrar um webhook a partir do qual receberá o tipo do evento e a url de download do arquivo (.csv).
O webhook estará diretamente associado ao ClientId, não sendo possível ter múltiplos webhooks para um mesmo Client. Atualizações no webhook devem ser feitas por meio da rota desta seção.
Apenas eventos de tipo PIX utilizam essa estratégia de notificação.
O resultado será informado através do código de status HTTP da resposta.
| HTTP Status Code | Descrição |
|---|---|
| 201 | Webhook cadastrado com sucesso |
| 400 | Erro nos parâmetros informados |
| 404 | Erro no formato da URL ou no método enviado |
| 409 | Erro de conflito, pois webhook já foi cadastrado |
| 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 |
Validação da URL de notificação
Ao cadastrar um webhook, nós enviaremos uma requisição de validação (HTTP POST) para a URL informada antes de concluir a operação. A URL precisa responder com sucesso (HTTP 2xx) dentro de 3 segundos; caso contrário, a requisição será rejeitada e o webhook não é cadastrado.
Corpo da notificação enviada
{
"type": "validation_notification"
}
Authorization: ConciliadorasComo gerar seu token de acesso
Para autenticação nesse endpoint, é necessário utilizar um token de acesso válido atrelado a qualquer cliente da conciliadora. Como o cadastro de webhook é feito pelo ClientId da conciliadora, só precisa ser feito uma vez e o mesmo será usado para todos os clientes.
Authorization: Cliente StonePara se autenticar conosco você deve enviar a Chave de API no cabeçalho Authorization, seguindo o padrão da HTTP Basic Authentication.
Para montar a requisição Basic Auth, você deve utilizar sua Chave Secreta da seguinte maneira:
User: chave Password: vazio