Visão Geral

O que são webhooks?

Webhooks são notificações HTTP enviadas automaticamente pela Accithus para a sua aplicação quando eventos importantes acontecem, como a captura de uma cobrança, um estorno ou um chargeback. Em vez de consultar a API periodicamente para verificar mudanças (polling), você configura endpoints de webhook e a Accithus envia um POST com os dados do evento assim que ele ocorre.

Como funciona

Você cria um ou mais endpoints de webhook no painel, cada um com uma URL e os eventos que deseja receber
Quando um evento ocorre, a Accithus envia um HTTP POST para todos os endpoints ativos que estão inscritos nesse evento
Sua aplicação processa a notificação e responde com um status 2xx
Se a entrega falhar, a Accithus reenvia automaticamente com backoff exponencial

Múltiplos endpoints

Você pode configurar quantos endpoints quiser. Cada endpoint possui:

Campo	Descrição
URL	A URL que receberá as notificações via HTTP POST
Eventos	Lista de eventos que este endpoint recebe (ex: `charge.captured`, `charge.refunded`)
Secret	Chave HMAC-SHA256 exclusiva para verificar a autenticidade das notificações
Status	`active` (recebe notificações) ou `paused` (temporariamente desativado)

Cada endpoint tem seu próprio secret. Isso permite que você integre com múltiplos sistemas, cada um com sua própria chave de verificação.

Estrutura do payload

Todos os webhooks seguem a mesma estrutura de envelope, com o campo de dados variando conforme o tipo de evento:

{
  "id": "uuid-do-delivery-log",
  "event": "charge.captured",
  "charge": { "..." },
  "occurred_at": "2026-02-24T10:00:00.000Z"
}

{
  "id": "uuid-do-delivery-log",
  "event": "submerchant.approved",
  "submerchant": { "..." },
  "occurred_at": "2026-03-30T14:00:00.000Z"
}

{
  "id": "uuid-do-delivery-log",
  "event": "withdrawal.completed",
  "withdrawal": { "..." },
  "occurred_at": "2026-03-30T14:05:00.000Z"
}

{
  "id": "uuid-do-delivery-log",
  "event": "infraction.opened",
  "infraction": { "..." },
  "occurred_at": "2026-07-03T09:30:00.000Z"
}

Campo	Tipo	Descrição
`id`	`string`	Identificador único da entrega (delivery log)
`event`	`string`	Nome do evento (ex: `charge.captured`, `submerchant.approved`, `withdrawal.completed`, `infraction.opened`)
`charge`	`object`	Dados da cobrança (presente em eventos `charge.*`)
`submerchant`	`object`	Dados do submerchant (presente em eventos `submerchant.*`)
`withdrawal`	`object`	Dados do saque (presente em eventos `withdrawal.*`)
`infraction`	`object`	Dados da infração (presente em eventos `infraction.*`)
`occurred_at`	`string`	Data/hora em que o evento ocorreu (ISO 8601)

Headers HTTP

Cada notificação inclui os seguintes headers:

Header	Descrição
`Content-Type`	`application/json`
`X-Accithus-Signature`	Assinatura HMAC-SHA256 do payload (ex: `sha256=abc123...`)
`X-Accithus-Event`	Nome do evento (ex: `charge.captured`)
`X-Accithus-Delivery-Id`	ID único da entrega
`User-Agent`	`Accithus-Postback/1.0`

Eventos disponíveis

Cobranças

Eventos de criação, captura, estorno e falha de cobranças

Submerchants

Eventos de aprovação, rejeição e suspensão de submerchants

Saques

Eventos de solicitação, aprovação, processamento e conclusão de saques

Infrações

Eventos de abertura, defesa e resolução de infrações MED

Começando

Cobranças

Submerchants

Financeiro

Configuração

SDK de Segurança

Webhooks

O que são webhooks?

Como funciona

Múltiplos endpoints

Estrutura do payload

Headers HTTP

Eventos disponíveis

Cobranças

Submerchants

Saques

Infrações

​O que são webhooks?

​Como funciona

​Múltiplos endpoints

​Estrutura do payload

​Headers HTTP

​Eventos disponíveis

Cobranças

Submerchants

Saques

Infrações

O que são webhooks?

Como funciona

Múltiplos endpoints

Estrutura do payload

Headers HTTP

Eventos disponíveis