Pular para o conteúdo principal

Webhooks e auditoria

Webhooks​

Quando uma ordem muda de status (ex.: paga, expirada), a Paychain pode enviar um POST para a URL configurada:

  • Perfil: webhook_url em PATCH /users/me
  • Por ordem: campo webhookUrl em POST /orders (sobrescreve para aquela ordem)

O payload inclui campos como reference, status, txId, amount, network, token e, quando existirem, dados de cotação (quoteCurrency, quoteAmount, fxRateLabel, fxSource).

Implemente o endpoint com:

  • Resposta 2xx rápida quando processar (ou enfileirar) o evento
  • Idempotência por reference + status se necessário

Consultar entregas de webhook​

Para suporte e debug:

GET /orders/:reference/webhook-deliveries

Lista tentativas, payload enviado e trecho da resposta HTTP.

Telegram​

Se configurado, notificações podem ser enviadas ao Telegram. Histórico:

GET /orders/:reference/telegram-deliveries

Linha do tempo (auditoria)​

GET /orders/:reference/audit

Eventos como criação da ordem, envio de tx, etc., em ordem cronológica — útil para conciliação e suporte N2.