Skip to main content

Visao geral

A AXNPAY envia webhooks assinados para notificar mudancas de status de transacao e saque. No fluxo de cobranca:
  1. A AXNPAY recebe a confirmacao do processador interno.
  2. A AXNPAY atualiza a transacao.
  3. A AXNPAY envia o webhook normalizado para o merchant.
Headers enviados:
  • X-Webhook-Event
  • X-Webhook-Signature (HMAC SHA-256 em hexadecimal)

Eventos disponiveis

  • transaction.created
  • transaction.completed
  • transaction.failed
  • transaction.reversed
  • transaction.cancelled
  • transaction.chargeback
  • cashout.created
  • cashout.processing
  • cashout.completed
  • cashout.failed
  • cashout.reversed

Payload base

Quando a cobranca for criada com tracking_parameters, a AXNPAY repassa esses dados no webhook dentro de trackingParameters, tracking_parameters e tambem nos campos planos utm_*.

Validacao da assinatura (Node.js)

Requisitos do seu endpoint

  1. Aceitar POST application/json.
  2. Responder 2xx rapidamente.
  3. Persistir o evento antes de processar regra pesada.
  4. Ignorar evento duplicado com base em event + referenceId + timestamp ou chave equivalente.

Endpoints de gerenciamento de webhook

Esses endpoints usam autenticacao JWT de usuario do painel, nao sk_live_prod_*:
  • GET /v1/user/webhooks/events
  • POST /v1/user/webhooks
  • GET /v1/user/webhooks
  • GET /v1/user/webhooks/:id
  • PATCH /v1/user/webhooks/:id
  • DELETE /v1/user/webhooks/:id
  • POST /v1/user/webhooks/:id/revalidate
Se voce estiver usando checkout de cartao, veja tambem Cartao.