These docs are for v1.0. Click to read the latest docs for v4.1.

Comunidade

Ask a Question
Back to all

Webhooks de assinaturas não estão sendo recebidos

Problema:
Não estou recebendo notificações de webhooks para eventos de assinaturas/recorrência (subscription.activated, subscription.suspended, etc.), apesar de ter a infraestrutura funcionando corretamente.
O que já funciona:
Webhooks de checkout/pagamentos estão sendo recebidos normalmente
URL do webhook está acessível publicamente via ngrok: https://c303aaa8fef1.ngrok-free.app/api/webhooks/pagbank/payment
ndpoint responde corretamente quando testado manualmente (curl)
O que NÃO está funcionando:
Ao suspender ou ativar uma assinatura, nenhuma notificação é enviada para minha URL
Eventos de assinaturas não chegam no meu webhook
Ações já realizadas:

Configurei a URL do webhook
Verifiquei que a URL está acessível (webhooks de checkout funcionam)
Implementei validação de assinatura (X-Authenticity-Token)
Testei manualmente o endpoint (responde corretamente)

Dúvidas/Solicitações:

Como cadastrar a URL de webhook especificamente para eventos de assinaturas/recorrência?

Existe um painel separado para configurar webhooks de assinaturas?
É necessário fazer via API? Se sim, qual endpoint?

Qual é o endpoint da API para gerenciar notification-urls de assinaturas?

Sandbox: https://sandbox.api.assinaturas.pagseguro.com/notification-urls ?
Produção: https://api.assinaturas.pagseguro.com/notification-urls ?

Os tokens de autenticação são os mesmos para:

API de Checkout
API de Assinaturas

Como listar as URLs de webhook atualmente cadastradas para assinaturas?
Existe algum requisito especial ou configuração adicional necessária para receber webhooks de assinaturas?

Ambiente:

Ambiente de testes: Sandbox (ou Produção, se for o caso)
URL do webhook: https://c303aaa8fef1.ngrok-free.app/api/webhooks/pagbank/payment
Eventos desejados:

subscription.initial
subscription.activated
subscription.suspended
subscription.recurrence
subscription.canceled
subscription.migrated
subscription.expired

Informações adicionais:

Já possuo assinaturas criadas e ativas no sistema
Testes de suspender/ativar assinaturas foram realizados, mas nenhuma notificação foi recebida
Webhooks de checkout funcionam perfeitamente na mesma URL

© 1996- Todos os direitos reservados.

PAGSEGURO INTERNET INSTITUIÇÃO DE PAGAMENTO S/A - CNPJ/MF 08.561.701/0001-01

Av. Brigadeiro Faria Lima, 1.384, São Paulo - SP - CEP 01451-001