PIX - Atualização de Webhook

Nome	Obrigatório	Tipo	Descrição
`Content-Type`	sim	string	(padrão: `application/json`)
`x-user-type`	não	string	Deve ser usado somente se você for cliente Stone, utilizando sua chave própria criada diretamente no portal (padrão: `client`)
`accept`	não	string

Campo	Tipo	Obrigatório	Descrição
url	string	sim
headers	string	não

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

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: Conciliadoras

Como 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 Stone

Para 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

Jornada: Baixar o arquivo de conciliação
Etapa 8 de 10

Etapa anteriorPIX - Cadastro de Webhook Próxima etapaArquivo PIX

PIX - Atualização de Webhook

Endpoint

Headers

Corpo da requisição