| 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 |
|---|---|
| 204 | Webhook atualizado com sucesso |
| 400 | Erro nos parâmetros informados |
| 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 |
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