Para quem vende · API e webhooks

Webhooks: eventos de transação, saque, disputa e sessão

Os eventos cobrem transação (criada, paga, cancelada, reembolsada, contestada, Pix expirado), saque (criado, concluído, falhou), disputa (MED e chargeback) e sessão do checkout (inclusive carrinho abandonado) e, se você assinar, um ORDER_BUMP_PAID por order bump pago. Todo aviso traz o token e o identifier.

Passo a passo

Cadastre a URL no painel ou mande callbackUrl na criação (a resposta traz o webhookToken).
Confira o token do corpo (e a assinatura do cabeçalho) antes de processar.
Trate cada evento de forma idempotente pelo id do evento.
Responda 2XX em até 10 s; processe o resto em segundo plano.

Já tem conta? Este passo a passo fica em Abrir Webhooks, no painel.

Isso ajudou?

Artigos relacionados

Saldo e saques: os saldos da conta e o saldo compensadoNo topo de Saldo e saques, os saldos da conta que não mudam com o período: disponível para saque, a liberar (só quando há valor), retido, em contestação e total sacado. Conta sem saldo nenhum e sem saque vê uma linha só ("Sem saldo ainda") no lugar dos cartões zerados. No Histórico, uma linha com o resumo do período (concluído, pendente e falhou ou cancelado) segue o filtro da tabela, e cada linha da tabela abre o saque. Se um método ficar negativo (por exemplo, uma contestação no cartão), o positivo do outro compensa: o disponível é o total real e aparece o aviso "Disponível diferente do saldo real"; com o total zerado ou negativo, o saque volta quando ficar positivo.
Como solicitar um saqueO saque sai do saldo disponível para a sua chave Pix cadastrada. A tela confere o valor antes de qualquer código: abaixo do mínimo, acima do máximo, acima do limite do dia ou do seu saldo, o motivo aparece embaixo do campo e o pedido nem sai. Com o valor certo, confirmamos que é você com um código (do app autenticador ou do e-mail), numa janela que abre depois do clique e diz o que você está confirmando: o valor que sai do saldo, a chave (mascarada) e quanto você recebe. O botão Tudo preenche o maior valor que dá para pedir agora, já com a taxa de saque e os limites (disponível, máximo por saque, limite do dia e o 1º saque da chave nova): com a taxa descontada, o saldo inteiro sai e você recebe o saldo menos a taxa; com Receber o valor exato, o campo fica com o saldo menos a taxa. A linha embaixo do campo diz, antes do clique, quanto sai do saldo e quanto chega (ex.: "Tudo usa R$ 150,00 do saldo. Você recebe R$ 145,01 (taxa R$ 4,99).") ou por que não dá. O valor de reembolsos já pedidos das suas vendas fica reservado (aparece como "Reservado para reembolsos pedidos") até o reembolso ser concluído ou recusado.
Contestações (MED e chargeback) na sua contaQuando o banco do comprador contesta um pagamento, a venda aparece em Vendas › Contestações e o valor fica retido até a decisão. Contestação perdida devolve o valor ao comprador e pode ter tarifa e multa.
Por que meu dinheiro está retidoNenhum real fica preso sem explicação. Em Saldo e saques, no Início, em Recebimentos e em Saúde da conta, o quadro "Por que parte do dinheiro ainda não está disponível" mostra cada valor que ainda não dá para sacar com três coisas: o motivo, a data prevista de liberação e o que você pode fazer. Os motivos são sempre um destes tipos: prazo normal de liberação (vendas esperando o prazo do meio de pagamento), reserva de segurança (uma parte guardada por um tempo para cobrir reembolso e contestação), MED ou chargeback em aberto (o comprador contestou e o valor espera a decisão), venda ou saque em análise de risco (uma conferência de rotina da Korvex), conferência de segurança (alerta de acesso ou troca de chave), pendência de cadastro (e-mail, documentos ou senha) e reembolso pedido. Quando há data, ela aparece ("Prevista para 25/10" ou "A partir de 25/10", com a última parte). Quando não há, aparece "Sem data" com do que depende, por exemplo da decisão do banco do comprador, e o que você pode fazer para soltar antes, como mandar a defesa até o prazo ou enviar um documento. O motivo é sempre o tipo da retenção: as regras internas de risco e os limites não aparecem. Se a Korvex esconde os dias de retenção da sua conta, a reserva aparece sem data.