Perguntas frequentes

As entregas que falham são repetidas automaticamente, até 15 vezes ao longo de cerca de 32 horas (política de novas tentativas).

Depois disso:

• Invoice paga: peça o reenvio com Reenviar webhook. Chega uma entrega nova de invoice.paid, com outro x-Webhook-Event-Id, às inscrições que assinam esse evento.
• Cobrança (/charge): não há reenvio. Consulte o estado atual com Consultar cobrança ou Buscar cobrança pela referência.

1. A inscrição está active? Consulte com Listar inscrições. Uma inscrição pausada não recebe nada, e eventos gerados enquanto ela estava pausada não são entregues depois.
2. O failureCount da inscrição está subindo? Então as entregas chegam, mas a sua URL não responde 2xx em até 10 segundos.
3. A URL é pública, https, sem redirecionamento, numa porta permitida (80, 443, 8080 ou 8443)? Redirecionamento conta como falha, e endereço não permitido pausa a inscrição.
4. O nome do evento em subscribedEvents está exatamente como no catálogo? Um nome com erro de grafia é aceito, mas nunca recebe nada.

O segredo só aparece na criação. Gere um novo com Rotacionar segredo e atualize o seu servidor. O anterior deixa de valer na hora.

É esperado: a entrega é pelo menos uma vez. Guarde o x-Webhook-Event-Id de cada entrega processada e ignore repetições. Veja Idempotência.

A chave de API está ausente, fora do formato ou inválida. Envie Authorization: Bearer <chave> e teste com Validar chave de API. Veja Autenticação.

O IP de saída do seu servidor não está cadastrado na conta. Cadastre em Integração no painel. Veja Liberação de IP.

A chave não é exibida de novo. Gere uma nova no painel, troque nos seus servidores e avise o suporte se a anterior precisar ser invalidada.

Confirme pela API, que é a fonte da verdade: Buscar cobrança pela referência com o seu número de pedido. Se ela estiver PAID, o problema está no recebimento do webhook; veja "O webhook não chega" acima.

A attemptIdempotencyKey já foi usada: a primeira tentativa foi criada. Não crie outra; busque a cobrança pelo externalReference.

Até 7 dias depois da criação da cobrança, desde que ela esteja paga. Alguns meios de pagamento só aceitam reembolso total. Veja Reembolsar cobrança.

Com Cancelar assinatura. O cancelamento não pode ser desfeito; para voltar a cobrar, crie uma assinatura nova.

R$ 3,00 no padrão; a sua conta pode ter outro mínimo. Veja Regras de negócio.

Depende do meio de pagamento. Veja Quando o dinheiro fica disponível.

O card Retido MED é uma reserva de segurança sobre as vendas PIX: uma parte de cada venda fica guardada por um prazo e é liberada inteira se nenhum pedido de devolução (MED) usar o valor. Veja MED.

Convide cada pessoa como membro, com o próprio login. Para quem só precisa ver relatórios, use o papel Operador. Veja Membros e acessos.

Não. O mesmo login opera mais de uma empresa, cada uma com saldo, chaves e webhooks próprios. Veja Mais de uma empresa.

Esses dados não são editáveis no painel. Fale com o suporte; veja Suporte para o que enviar.