Criar webhook

Cria um webhook para receber notificações de eventos de assinatura.

Eventos de assinatura enviados (um webhook por evento):

Evento	Descrição
`assinatura_criada`	Adesão criada
`assinatura_ativada`	Primeiro pagamento confirmado; assinatura ativa
`assinatura_renovada`	Ciclo a partir do 2º pago
`assinatura_em_atraso`	Pagamento vencido dentro do grace period
`assinatura_suspensa`	Suspensa por inadimplência ou manualmente
`assinatura_reativada`	Reativada após suspensão
`assinatura_cancelada`	Cancelada definitivamente
`assinatura_plano_alterado`	Plano da assinatura mudou
`assinatura_expirada`	Expirou
`assinatura_completada`	Chegou ao último ciclo
`cobranca_gerada`	Cobrança do ciclo criada
`cobranca_paga`	Cobrança paga
`cobranca_falhou`	Cobrança falhou
`cobranca_retentativa`	Nova tentativa agendada

mandato_ativado e mandato_cancelado são aceitos no cadastro, mas
hoje não são enviados. O evento all não recebe eventos de
assinatura.

A resposta traz o segredo do webhook em token (só neste momento; para
trocar, POST /webhooks/{id}/rotate-secret). Ele assina cada entrega no
cabeçalho X-Webhook-Signature: sha256=<HMAC-SHA256 do corpo bruto>;
o nome do evento vai em X-Subscription-Event.

A URL configurada receberá um POST com o payload do evento. Certifique-se
de que o endpoint retorne 2xx em até 30 segundos.

Bearer Token

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

curl --location '/api/partner/v1/webhooks' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "title": "Assinaturas — Produção", "url": "https://meusite.com.br/webhooks/syncpay", "event": "assinatura_ativada", "trigger_all_products": true }'

{ "id": 42, "title": "Assinaturas — Produção", "url": "https://meusite.com.br/webhooks/syncpay", "event": "assinatura_ativada", "trigger_all_products": true, "products": [], "token": "segredo-exemplo-mostrado-uma-vez", "created_at": "2026-07-06 10:00:00" }

Requisição

Respostas