1. Conecte o Stripe
Em Integrações, conecte por OAuth. O acesso é somente leitura: o Keep nunca
cria, altera nem cancela cobrança, e nenhum token seu é armazenado — as chamadas
usam a chave de plataforma com um cabeçalho identificando a sua conta.
2. Gere uma chave de API
Em Chaves de API, clique em Nova chave e dê um nome que você reconheça
daqui a seis meses. É por ele que você vai decidir qual revogar.
O segredo aparece uma única vez. Guardamos apenas o hash, então nem nós
conseguimos mostrá-lo depois. Se perder, gere outro e revogue o anterior.
3. Mande atividade
Uma chamada do seu backend, onde você já sabe quem é o usuário. Uma por login
costuma bastar.
Mandar o stripeCustomerId é o que faz o casamento ser exato: o mesmo id
chega do outro lado, vindo do próprio Stripe. Só com e-mail, vale a heurística
de domínio — que falha justamente quando quem paga não é quem usa.
4. Espere duas semanas
O Keep compara os últimos 7 dias contra os 7 anteriores. Antes de existirem duas
janelas, não há o que comparar.
Se você quiser resultado imediato, mande um backfill: o endpoint aceita um array
de até 500 eventos por chamada, com at no passado.