Valut Gateway
    Valut Gateway
    • Overview
    • Webhooks
    • Error codes
    • Transactions
      • Criar uma Transação
        POST
      • Criar uma Transação Com 3DS
        POST
      • Criar uma Transação PIX
        POST
      • Estornar uma transação
        POST
      • Capturando uma Transação
        POST
      • Buscar Transação
        GET
      • Listar Transações
        GET
      • Retornar Histórico de uma Transação
        GET
      • Retornar Parcelas de uma transação
        GET
    • Payment Links
      • Criar Link
        POST
      • Atualizar Link
        PUT
      • Buscar Link
        GET
      • Listar Links
        GET
      • Transações de um link
        GET
    • Customer
      • Criar Cliente
        POST
      • Encontrar Cliente
        POST
      • Cartões do Cliente
        POST
      • Atualizar Cliente
        PUT
      • Buscar Cliente
        GET
      • Listar Clientes
        GET
      • Deletar um cliente
        DELETE
    • Cards
      • Criar Cartão
        POST
      • Obter Bandeira
        POST
      • Buscar Cartão
        GET
      • Listar Cartões
        GET
    • Webhook
      • Criar um webhook
      • Atualizar Webhook
      • Retornar Webhooks Cadastrados
      • Retornar um Webhook
      • Remover um Webhook
    • Simulate
      • Tax

    Webhooks

    Conceito Básico#

    Gatilhos (ou Webhooks) são endereços (URLs) para onde a Valut dispara avisos (Via método POST) para certos eventos que ocorrem em sua conta.
    As chamadas são enviadas com content-type application/json
    Os gatilhos podem ser cadastrados pelo painel da Valut em Webhooks.
    TipoDescrição
    transaction.createdOcorre sempre que um transação é criada.
    transaction.status_changedOcorre quando o status da transação é alterado.
    link.createdOcorre sempre que um Link é criado.
    link.changedOcorre quando um Link é alterado.
    link.paidOcorre quando um Link é pago.
    customer.createdOcorre sempre que um Cliente é criado.
    customer.changedOcorre quando um Cliente é alterado.

    Objeto de envio#

    O objeto de envio dos webhooks consiste num padrão de evento, onde o payload é alterado de acordo com o seu contexto.

    Objeto default#

    {
       "event":"transaction.status_changed",
       "model":"transactions",
       "model_id":"123097",
       "payload":{…}
    }

    Objetos de payload#

    Transactions
    Links
    Customer
    Objeto do contexto de transações.
    Modificado em 2025-05-26 19:25:28
    Página anterior
    Overview
    Próxima página
    Error codes
    Built with