Communitygithub.com

고객 청구 운영

Stripe와 같은 연결된 청구 도구를 사용하여 구독, 환불, 이탈 분류, 청구 포털 복구 및 요금제 분석 등 고객 청구 워크플로를 운영합니다. 고객 지원, 구독 상태 확인 또는 수익에 영향을 미치는 청구 작업 관리가 필요할 때 사용하세요.

고객 청구 운영란 무엇인가요?

이 스킬은 고객 청구 운영을 위한 전용 워크플로를 제공하며, 일반적인 결제 API 설계가 아닌 실제 고객 운영에 초점을 맞춥니다. 주요 목표는 고객 신원 확인, 문제 분류, 안전한 해결책 선택, 후속 조치 안내 등 청구 관련 문제를 체계적으로 처리하는 것입니다. Stripe와 같은 연결된 청구 도구를 우선 활용하며, 이메일이나 GitHub는 보조 증거로만 사용합니다. 또한, 환불 전 문제 유형(중복 구매, 의도된 멀티시트, 결제 실패 등)을 분류하고, 가장 안전하고 되돌릴 수 있는 조치를 먼저 취하도록 안내합니다. 최종적으로 고객 상태 요약, 수행된 조치, 수익 영향, 후속 메시지 및 제품 개선 사항을 포함한 운영자 핸드오프를 생성합니다. Cursor, Claude Code, Codex, Windsurf, Cline, Copilot 등 다양한 AI 에이전트 플랫폼에서 사용 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/customer-billing-ops

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

고객 청구 운영 (Customer Billing Ops)

이 스킬은 일반적인 결제 API 설계가 아닌 실제 고객 운영을 위해 사용하세요.

목표는 운영자가 다음 질문에 답할 수 있도록 돕는 것입니다: 이 고객은 누구인가, 무슨 일이 있었는가, 가장 안전한 해결책은 무엇인가, 어떤 후속 조치를 보내야 하는가?

사용 시기

  • 고객이 청구에 문제가 있다고 말하거나, 환불을 원하거나, 취소할 수 없다고 할 때
  • 중복 구독, 우발적 청구, 실패한 갱신 또는 이탈 위험을 조사할 때
  • 요금제 구성, 활성 구독, 연간 vs 월간 전환, 팀 시트 혼동을 검토할 때
  • 청구 포털 흐름을 생성하거나 검증할 때
  • 구독, 인보이스, 환불 또는 결제 방법과 관련된 지원 불만을 감사할 때

선호 도구 표면

  • Stripe와 같은 연결된 청구 도구를 먼저 사용하세요.
  • 이메일, GitHub 또는 이슈 트래커는 보조 증거로만 사용하세요.
  • 플랫폼에서 이미 필요한 제어 기능을 제공하는 경우, 맞춤 계정 관리 코드보다 호스팅된 청구/고객 포털을 선호하세요.

가드레일

  • 응답에 비밀 키, 전체 카드 세부 정보 또는 불필요한 고객 PII를 절대 노출하지 마세요.
  • 무턱대고 환불하지 말고, 먼저 문제를 분류하세요.
  • 다음을 구분하세요:
    • 우발적 중복 구매
    • 의도된 멀티시트 또는 팀 구매
    • 제품 결함 / 가치 불충족
    • 실패했거나 완료되지 않은 체크아웃
    • 셀프 서비스 제어 부족으로 인한 취소
  • 연간 요금제, 팀 요금제 및 비례 배분 상태의 경우, 조치를 취하기 전에 계약 형태를 확인하세요.

워크플로

1. 고객을 명확하게 식별하세요

사용 가능한 가장 강력한 식별자부터 시작하세요:

  • 고객 이메일
  • Stripe 고객 ID
  • 구독 ID
  • 인보이스 ID
  • 청구에 매핑되는 것으로 알려진 GitHub 사용자 이름 또는 지원 이메일

간결한 신원 요약을 반환하세요:

  • 고객
  • 활성 구독
  • 취소된 구독
  • 인보이스
  • 중복 활성 구독과 같은 명백한 이상 징후

2. 문제를 분류하세요

조치를 취하기 전에 사례를 하나의 버킷에 넣으세요:

사례일반적인 조치
중복 개인 구독추가 항목 취소, 환불 고려
실제 멀티시트/팀 의도시트 유지, 청구 모델 명확히 설명
결제 실패 / 완료되지 않은 체크아웃포털을 통해 복구하거나 결제 방법 업데이트
셀프 서비스 제어 부족포털, 취소 경로 또는 인보이스 액세스 제공
제품 결함 또는 신뢰 붕괴환불, 사과, 제품 이슈 기록

3. 가장 안전하고 되돌릴 수 있는 조치를 먼저 취하세요

선호 순서:

  1. 셀프 서비스 관리 복원
  2. 중복 또는 손상된 청구 상태 수정
  3. 영향을 받은 요금 또는 중복에 대해서만 환불
  4. 이유 문서화
  5. 짧은 고객 후속 조치 전송

수정에 제품 작업이 필요한 경우, 다음을 분리하세요:

  • 지금 고객 문제 해결
  • 백로그를 위한 제품 버그 / 워크플로 격차

4. 운영자 측 제품 격차 확인

고객의 불편이 운영자 표면의 부재로 인한 경우 명시적으로 지적하세요. 일반적인 예:

  • 청구 포털 없음
  • 사용량/속도 제한 가시성 없음
  • 요금제/시트 설명 없음
  • 취소 흐름 없음
  • 중복 구독 방지 없음

이러한 항목을 단순한 지원 인시던트가 아닌 ECC 또는 웹사이트 후속 항목으로 처리하세요.

5. 운영자 핸드오프 생성

다음으로 마무리하세요:

  • 고객 상태 요약
  • 수행된 조치
  • 수익 영향
  • 보낼 후속 메시지
  • 생성할 제품 또는 백로그 이슈

출력 형식

다음 구조를 사용하세요:

CUSTOMER
- 이름 / 이메일
- 관련 계정 식별자

BILLING STATE
- 활성 구독
- 인보이스 또는 갱신 상태
- 이상 징후

DECISION
- 문제 분류
- 이 조치가 올바른 이유

ACTION TAKEN
- 환불 / 취소 / 포털 / 작업 없음

FOLLOW-UP
- 짧은 고객 메시지

PRODUCT GAP
- 제품 또는 웹사이트에서 수정해야 할 사항

좋은 권장 사항 예시

  • "올바른 해결책은 맞춤 대시보드가 아닌 청구 포털입니다"
  • "이는 실제 팀 시트 구매가 아닌 중복 개인 체크아웃으로 보입니다"
  • "중복 요금 중 하나는 환불하고 나머지 활성 구독은 유지한 후, 나중에 필요하면 고객을 조직 청구로 전환하세요"

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

관련 스킬