Lar

Skill

Outros

customer-billing-ops

affaan-m/ECC

Gerenciar fluxos de trabalho de faturamento de clientes, como assinaturas, reembolsos, triagem de cancelamentos, recuperação do portal de faturamento e análise de planos, utilizando ferramentas de faturamento integradas, como o Stripe.

...Expandir tudo

Tempo atualizado 12 de Outubro de 2026

# stripe # churn # subscriptions # refunds # billing portal # customer support # invoicing

Operações de faturamento de clientes

Utilize essa habilidade para operações reais com clientes, e não para o projeto genérico de APIs de pagamento.

O objetivo é ajudar o operador a responder: quem é esse cliente, o que aconteceu, qual é a solução mais segura e qual acompanhamento devemos enviar?

Quando usar

O cliente alega que o faturamento está com problema, quer um reembolso ou não consegue cancelar
Investigação de assinaturas duplicadas, cobranças acidentais, renovações com falha ou risco de cancelamento
Analisar o mix de planos, assinaturas ativas, conversão anual versus mensal ou confusão entre licenças de equipe
Criação ou validação do fluxo de um portal de cobrança
Auditar reclamações de suporte relacionadas a assinaturas, faturas, reembolsos ou formas de pagamento

Ferramentas recomendadas

Use primeiro ferramentas de faturamento conectadas, como o Stripe
Use e-mail, GitHub ou sistemas de rastreamento de problemas apenas como evidência de apoio
Dê preferência a portais de faturamento/atendimento ao cliente hospedados em vez de código personalizado de gerenciamento de contas, quando a plataforma já oferecer os controles necessários

Medidas de proteção

Nunca exponha chaves secretas, detalhes completos de cartões ou informações pessoais identificáveis (PII) desnecessárias do cliente na resposta
Não faça reembolsos cegamente; primeiro classifique o problema
Distinga entre:
- compra duplicada acidental
- compra deliberada de várias licenças ou para equipe
- produto com defeito / valor não atendido
- finalização de compra com falha ou incompleta
- cancelamento devido à falta de controles de autoatendimento
Para planos anuais, planos de equipe e estados com cobrança proporcional, verifique as condições do contrato antes de tomar qualquer medida

Fluxo de trabalho

1. Identifique o cliente com precisão

Comece pelo identificador mais confiável disponível:

e-mail do cliente
ID do cliente no Stripe
ID da assinatura
ID da fatura
nome de usuário do GitHub ou e-mail de suporte, caso se saiba que está vinculado ao faturamento

Retorne um resumo conciso da identidade:

cliente
assinaturas ativas
assinaturas canceladas
faturas
anomalias evidentes, como assinaturas ativas duplicadas

2. Classifique o problema

Classifique o caso em uma das categorias antes de agir:

Caso	Ação típica
Assinatura pessoal duplicada	cancelar itens extras, considerar reembolso
Intenção real de uso em várias licenças/equipe	manter as licenças, esclarecer o modelo de cobrança
Pagamento com falha / finalização da compra incompleta	recuperar pelo portal ou atualizar a forma de pagamento
Falta de controles de autoatendimento	fornecer acesso ao portal, ao processo de cancelamento ou à fatura
Falha no produto ou quebra de confiança	Reembolsar, pedir desculpas, registrar o problema do produto

3. Tome primeiro a ação reversível mais segura

Ordem recomendada:

restaurar o gerenciamento por autoatendimento
corrigir estado de cobrança duplicado ou incorreto
reembolsar apenas a cobrança afetada ou duplicada
documentar o motivo
enviar uma breve mensagem de acompanhamento ao cliente

Se a correção exigir intervenção no produto, separar:

solução para o cliente agora
bug no produto / lacuna no fluxo de trabalho para a lista de pendências

4. Verifique as lacunas do produto do lado do operador

Se o problema do cliente decorrer da falta de uma interface para o operador, mencione isso explicitamente. Exemplos comuns:

ausência de portal de faturamento
ausência de visibilidade do uso/limite de taxa
ausência de explicação sobre planos/licenças
ausência de fluxo de cancelamento
ausência de proteção contra assinaturas duplicadas

Trate esses itens como ECC ou itens de acompanhamento do site, e não apenas como incidentes de suporte.

5. Realize o repasse ao operador

Conclua com:

resumo da situação do cliente
medidas tomadas
impacto na receita
texto de acompanhamento a ser enviado
problema relacionado ao produto ou ao backlog a ser criado

Formato de saída

Use esta estrutura:

CLIENTE
- nome / e-mail
- identificadores relevantes da conta

ESTADO DE FATURAMENTO
- assinaturas ativas
- estado da fatura ou da renovação
- anomalias

DECISÃO
- classificação do problema
- por que essa ação é correta

AÇÃO REALIZADA
- reembolso / cancelamento / portal / nenhuma ação

ACOMPANHAMENTO
- mensagem breve para o cliente

FALHA NO PRODUTO
- o que deve ser corrigido no produto ou no site

Exemplos de boas recomendações

“A solução correta é um portal de cobrança, e não um painel personalizado por enquanto”
“Isso parece um checkout pessoal duplicado, não uma compra real de licença para equipe”
“Reembolse uma cobrança duplicada, mantenha a assinatura ativa restante e, posteriormente, converta o cliente para o faturamento da organização, se necessário”

Ver no GitHub

---
name: customer-billing-ops
description: Operate customer billing workflows such as subscriptions, refunds, churn triage, billing-portal recovery, and plan analysis using connected billing tools like Stripe.
---

# Customer Billing Ops

Use this skill for real customer operations, not generic payment API design.

The goal is to help the operator answer: who is this customer, what happened, what is the safest fix, and what follow-up should we send?

## When to Use

- Customer says billing is broken, they want a refund, or they cannot cancel
- Investigating duplicate subscriptions, accidental charges, failed renewals, or churn risk
- Reviewing plan mix, active subscriptions, yearly vs monthly conversion, or team-seat confusion
- Creating or validating a billing portal flow
- Auditing support complaints that touch subscriptions, invoices, refunds, or payment methods

## Preferred Tool Surface

- Use connected billing tools such as Stripe first
- Use email, GitHub, or issue trackers only as supporting evidence
- Prefer hosted billing/customer portals over custom account-management code when the platform already provides the needed controls

## Guardrails

- Never expose secret keys, full card details, or unnecessary customer PII in the response
- Do not refund blindly; first classify the issue
- Distinguish among:
  - accidental duplicate purchase
  - deliberate multi-seat or team purchase
  - broken product / unmet value
  - failed or incomplete checkout
  - cancellation due to missing self-serve controls
- For annual plans, team plans, and prorated states, verify the contract shape before taking action

## Workflow

### 1. Identify the customer cleanly

Start from the strongest identifier available:

- customer email
- Stripe customer ID
- subscription ID
- invoice ID
- GitHub username or support email if it is known to map back to billing

Return a concise identity summary:

- customer
- active subscriptions
- canceled subscriptions
- invoices
- obvious anomalies such as duplicate active subscriptions

### 2. Classify the issue

Put the case into one bucket before acting:

| Case | Typical action |
|------|----------------|
| Duplicate personal subscription | cancel extras, consider refund |
| Real multi-seat/team intent | preserve seats, clarify billing model |
| Failed payment / incomplete checkout | recover via portal or update payment method |
| Missing self-serve controls | provide portal, cancellation path, or invoice access |
| Product failure or trust break | refund, apologize, log product issue |

### 3. Take the safest reversible action first

Preferred order:

1. restore self-serve management
2. fix duplicate or broken billing state
3. refund only the affected charge or duplicate
4. document the reason
5. send a short customer follow-up

If the fix requires product work, separate:

- customer remediation now
- product bug / workflow gap for backlog

### 4. Check operator-side product gaps

If the customer pain comes from a missing operator surface, call it out explicitly. Common examples:

- no billing portal
- no usage/rate-limit visibility
- no plan/seat explanation
- no cancellation flow
- no duplicate-subscription guard

Treat those as ECC or website follow-up items, not just support incidents.

### 5. Produce the operator handoff

End with:

- customer state summary
- action taken
- revenue impact
- follow-up text to send
- product or backlog issue to create

## Output Format

Use this structure:

```text
CUSTOMER
- name / email
- relevant account identifiers

BILLING STATE
- active subscriptions
- invoice or renewal state
- anomalies

DECISION
- issue classification
- why this action is correct

ACTION TAKEN
- refund / cancel / portal / no-op

FOLLOW-UP
- short customer message

PRODUCT GAP
- what should be fixed in the product or website
```

## Examples of Good Recommendations

- "The right fix is a billing portal, not a custom dashboard yet"
- "This looks like duplicate personal checkout, not a real team-seat purchase"
- "Refund one duplicate charge, keep the remaining active subscription, then convert the customer to org billing later if needed"