PARA PROGRAMADORESAPI HEADLESS

Tudo o que o NoChurn faz, disponível pela API.

Mantenha a sua faturação e os seus ecrãs. Envie clientes, pagamentos e cancelamentos, execute o fluxo de cancelamento na sua própria interface e receba webhooks assinados. Web, desktop, iOS ou Android.

api.nochurn.sh/v1
Exemplo animado de API headless no painel do NoChurn (dados de exemplo)

COMO FUNCIONA

Quatro passos, todos automáticos.

  1. 01

    Crie uma chave de teste

    Uma chave que começa por nc_test_ funciona numa sandbox: nada real é cobrado e nenhum email sai do NoChurn.

  2. 02

    Envie os seus dados

    Clientes, subscrições, pagamentos e cancelamentos, mais qualquer atributo ou evento de uso. Com o seu próprio id, um id do Stripe ou o nosso.

  3. 03

    Construa os seus ecrãs

    Obtenha os motivos e as ofertas do fluxo de cancelamento, mostre-os à sua maneira e envie a resposta de volta. Os textos chegam traduzidos.

  4. 04

    Ouça os webhooks

    O NoChurn diz à sua app o que fazer: tentar de novo este pagamento, aplicar este desconto, este cliente cancelou, aquele voltou.

O QUE CONTROLA

As suas regras, o seu tom, a sua decisão.

  • Três ids por cliente

    Use o seu próprio external id, o id de cliente do Stripe ou o id do NoChurn. Os três levam ao mesmo cliente.

  • Webhooks assinados

    Cada webhook é assinado (NoChurn-Signature) e reenviado com backoff até o seu endpoint responder.

  • Escritas idempotentes

    Envie uma Idempotency-Key em qualquer escrita, e um pedido repetido nunca corre duas vezes.

  • Chaves restritas

    Dê a cada chave acesso nenhum, de leitura ou de escrita por recurso. Uma chave não pode criar uma chave mais poderosa.

  • Chaves públicas para o front end

    Chaves pk_ e um token de cliente assinado permitem ao seu front end web ou móvel chamar diretamente o fluxo de cancelamento.

  • Erros que dizem a solução

    Cada erro tem um código, uma mensagem, a solução e um link para a documentação.

INCLUÍDO

Regras em que não precisa de pensar.

  • SANDBOX

    As chaves de teste ficam em teste

    Uma chave nc_test_ só vê dados de teste e nunca envia um email real nem movimenta dinheiro real.

  • CLICK TO CANCEL

    Um link de cancelamento em cada sessão

    Cada sessão de cancelamento devolve cancel_url_now, válido para toda a sessão, para que cancelar fique a um clique também na sua interface.

  • SEM SEGREDOS

    Nenhum segredo no seu front end

    Os front ends usam chaves públicas e tokens de cliente de curta duração. As chaves secretas ficam no seu servidor.

API

REST simples, webhooks assinados.

Alguns dos endpoints. A referência completa está na documentação, e o openapi.yaml é a fonte de verdade.

Referência da API
POST /v1/customers Criar um cliente com o seu próprio id
POST /v1/subscriptions Enviar uma subscrição
POST /v1/events Registar um evento de uso
POST /v1/cancel-sessions Iniciar um fluxo de cancelamento
POST /v1/webhook-endpoints Subscrever webhooks

FAQ

As perguntas mais frequentes.

Preciso do Stripe para usar o NoChurn?

Não. Com a API, o NoChurn funciona com faturação interna ou com qualquer fornecedor. O Stripe e os outros conectores só lhe poupam o trabalho de integração.

Um agente de código pode fazer a integração?

É essa a ideia do servidor MCP do NoChurn e do llms.txt: aponte o seu agente para eles com uma chave de teste, e ele pode ligar as chamadas e os webhooks no seu código.

Que plataformas podem mostrar o fluxo de cancelamento?

Todas. A API devolve JSON simples: motivos, ofertas e textos. Mostre-o na web, numa app desktop ou de forma nativa em iOS e Android.

Como mantenho as minhas chaves seguras?

As chaves secretas ficam no seu servidor. Os front ends usam chaves públicas pk_ com um token de cliente assinado, e as chaves restritas limitam aquilo a que cada chave tem acesso.

Mais do NoChurn

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://www.nochurn.sh/docs/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Pare de perder receita.

  • Grátis até $300 de MRR
  • Sem cartão
  • Pronto em 10 minutos
  • Nunca uma comissão sobre o que recuperamos