Pular para o conteúdo principal
No Node.js, o SDK oficial oferece constructWebhookEvent(rawBody, signature, secret) para validar a assinatura, o tempo e o envelope. Use os bytes originais recebidos e deduplique pelo identificador do evento no seu banco. O segredo é o do seu endpoint MingoPay. Cadastre uma URL HTTPS pública na área Webhooks do dashboard. Para integrações de sistemas, o segredo whsec_ aparece somente na criação.

Notificações no Discord

Em Novo endpoint, escolha Discord e cole a URL copiada em Configurações do canal > Integrações > Webhooks no Discord. Selecione o ambiente e salve. A URL oficial também é reconhecida automaticamente. Use Testar e confira o canal e o histórico de entregas. O aviso de fila é informativo: a confirmação de entrega aparece somente após resposta 2xx do destino; falhas mostram um aviso de erro. O resultado e a lista de entregas são atualizados em tempo real, sem recarregar a página. Um canal de texto comum é suficiente; URLs com parâmetros de threads não são aceitas. O painel inscreve pagamentos confirmados, devoluções, transferências concluídas ou com falha e atualizações de disputas. A mensagem exibe ID da transação MingoPay, status do evento, valor, taxa real registrada, data/hora de Brasília, ambiente e ID do evento. A taxa de devoluções/disputas se refere à transação original. Um teste se identifica como teste e não inventa valores ou status bancário. CPF, e-mail, chave Pix e payload completo não são enviados. Menções estão desativadas. A URL contém o token de acesso ao canal: mantenha-a privada. Ela é criptografada ao cadastrar e aparece mascarada na listagem. Não é necessário copiar um segredo whsec_ para usar o Discord. As mensagens usam o formato do Discord; o envelope e a assinatura descritos abaixo são exclusivos de endpoints de sistemas. Ambos os destinos mantêm histórico e retentativas. Uma resposta 429 do Discord aumenta a espera quando necessário, até uma hora. Entregas com resposta incerta podem produzir mensagem duplicada; confira o identificador na mensagem. Essa configuração usa a sessão do painel e suas permissões. Não adiciona rotas Bearer ou métodos ao SDK.

Formato da entrega

Histórico e detalhes

Em Entregas recentes > Detalhes, consulte status HTTP, tentativa, referência da operação, URL de destino, horários e resposta. Novas tentativas registram o corpo exato enviado, armazenado com criptografia. O histórico anterior mostra Dados do evento, com um aviso de que o corpo original não foi registrado. Reenviar falha mantém o mesmo identificador do evento e a numeração das tentativas. Abre até dez novas tentativas sem repetir endpoints já entregues. A ação exige endpoint ativo e evento falho ou esgotado; eventos na fila, em processamento ou já concluídos não são reenfileirados. Reenviar uma notificação não cria outra transação financeira.

Validar a assinatura

Leia o corpo bruto e calcule HMAC-SHA256 sobre timestamp + "." + rawBody.
Não faça parse e stringify do JSON antes de validar. A assinatura usa os bytes exatos recebidos.

Entrega segura

Persista o id do evento com restrição única, processe cada evento uma vez e responda 2xx somente depois de aceitá-lo. Falhas e timeouts geram novas tentativas com intervalo crescente, até 10 tentativas. Eventos de cobrança incluem payment_intent.pending, payment_intent.paid, payment_intent.failed, payment_intent.cancelled e payment_intent.refunded. O evento ping.test verifica o endpoint.