Docs/API Reference/Pagamentos
DashboardGitHub

A Dyvit processa pagamentos Pix via Mercado Pago. O fluxo é: o agente gera um QR code Pix, o devedor paga, e o webhook do Mercado Pago notifica a confirmação automaticamente.

Endpoints

#
MétodoEndpointDescrição
GET/api/payments/:debtIdStatus do pagamento (público, sem auth)
POST/api/payments/webhookWebhook IPN do Mercado Pago
ℹ️

O endpoint de status do pagamento é público e não requer autenticação. O webhook é chamado diretamente pelo Mercado Pago.


Status do pagamento

GET/api/payments/:debtId

Retorna o status atual do pagamento associado a uma dívida. Endpoint público, utilizado pelo frontend para polling de confirmação. Retorna PENDING, APPROVED, REJECTED ou CANCELLED.


Webhook IPN

POST/api/payments/webhook

Recebe notificações IPN (Instant Payment Notification) do Mercado Pago. Quando um pagamento Pix é confirmado, este endpoint atualiza o status da dívida, encerra a conversa e dispara a geração do recibo.

⚠️

Este endpoint é chamado exclusivamente pelo Mercado Pago. Não envie requisições manuais para ele.