Home
SiteDashboardInternet Bank
Home
SiteDashboardInternet Bank
  1. Embedded Bank
  • Home
  • Embedded Bank
    • Guias
    • Autenticação
    • Paginação
    • Idempotência
    • Erros
    • Data e Hora
    • Eventos e Webhooks
    • Modelo de dados
      • Entidades
      • Contas
      • Plataforma
      • Número de conta
      • Transferências
      • Pix Internacional
      • Cross-Border (Pagamentos Internacionais)
    • Conta
      • Detalhes de uma empresa
      • Criar uma Empresa
      • /entities/person
  • Gateway (Obsoleto)
    • Autenticação
      • Recebendo um token de acesso
    • Conta
      • Dados da conta
      • Visualizar saldo na conta
    • PIX
      • Pagamento
        • Iniciando e Confirmando o PIX
        • Listando Pagamentos de PIX
        • Detalhe de um Pagamento PIX
      • Recebimento
        • Criando QRCode PIX
        • Listando QRCodes
        • Detalhe de um QRCode
        • Devolvendo PIX Recebido
        • Encontrando pix pelo EndToEndId
        • Inativando um QRCode
    • Transferências
      • Consulta conta disponível transferências
      • Transferências entre contas P2P
      • Transferências entre contas P2P por Lote
      • Transferências entre contas TED
    • Boletos
      • Retornando lista de boleto emitidos
      • Emitindo um boleto
      • Cancelando um boleto
    • Pagamentos de Títulos
      • Consulta código de barras
      • Pagamento código de barras
    • Webhook
      • Criando um webhook
      • Listando webhooks
      • Removendo webhook
    • HealthCheck
      GET
  • Core
  • Esquemas
    • bussines_entity
    • Address
  1. Embedded Bank

Eventos e Webhooks

A Valut permite que você configure webhooks para receber notificações em tempo real sobre eventos da plataforma, como transferências, liquidações, onboarding e alterações de status.
Os webhooks podem ser configurados via API ou painel administrativo.

Configuração de Webhooks#

Cada endpoint deve ser um HTTPS válido
Deve aceitar requisições POST
O payload será enviado em formato JSON
É possível configurar múltiplos endpoints para diferentes tipos de eventos

⚠️ Limitação por tipo de evento#

Cada tipo de evento pode ser entregue a apenas um webhook por plataforma.
Exemplo:
Se dois endpoints estiverem inscritos para transfers.ach.*
Apenas o primeiro criado receberá os eventos
👉 Recomendação:
Distribua os eventos por domínio (ex: pagamentos, contas, compliance)

Estrutura do Evento#

Todos os eventos seguem o mesmo formato:
{
  "id": "evt_123456",
  "created_at": "2026-01-01T12:00:00Z",
  "type": "transfer.ach.completed",
  "data": {
    "id": "txn_789",
    "amount": 1000,
    "currency": "USD"
  }
}
Modificado em 2026-04-26 00:18:11
Página anterior
Data e Hora
Próxima página
Entidades
Built with