Stripe Payments

기본 구현 패턴

// 서버 (Node.js)
const session = await stripe.checkout.sessions.create({
  mode: 'payment',  // 또는 'subscription'
  line_items: [{
    price_data: {
      currency: 'usd',
      product_data: { name: 'Game Premium' },
      unit_amount: 999,  // $9.99 (센트 단위!)
    },
    quantity: 1,
  }],
  success_url: 'https://eastsea.monster/thanks?session_id={CHECKOUT_SESSION_ID}',
  cancel_url: 'https://eastsea.monster/games/',
});
// session.url로 리다이렉트

구독 모델 (SaaS/게임 프리미엄)

• Billing API → 구독 설계 가이드: docs.stripe.com/billing/subscriptions/designing-integration
• CheckoutSessions + Billing 조합 우선
• 웹훅으로 구독 상태 변경 감지

플랫폼 (여러 게임 개발자) → Connect

• destination charges — 우리가 liability 수용
• on_behalf_of 파라미터로 merchant of record 제어
• charge type 혼합 금지

보안 체크리스트

• 서버사이드에서만 시크릿 키 사용
• 웹훅 시그니처 검증
• 클라이언트에 금액/가격 하드코딩 금지 (서버에서 생성)
• Go-live 체크리스트 완료: docs.stripe.com/get-started/checklist/go-live
• HTTPS 필수

참고 문서

• 통합 옵션: docs.stripe.com/payments/payment-methods/integration-options
• API 투어: docs.stripe.com/payments-api/tour
• Go-live 체크리스트: docs.stripe.com/get-started/checklist/go-live

Guardrails

• 테스트 모드 vs 라이브 모드 명시적 구분 필수 — 코드 실행 전 현재 키가 sk_test_ (테스트) 또는 sk_live_ (라이브)인지 명시. 라이브 모드 작업 시 항상 로그에 [LIVE] 태그 출력.
• 금액/통화 변경 시 double-confirm — unit_amount, currency 값을 수정할 때는 변경 전/후 금액을 Master에게 확인 후 실행. 센트 단위 혼동($9.99 → 999) 주의.
• 웹훅 시크릿 노출 절대 금지 — STRIPE_WEBHOOK_SECRET 값을 로그, 응답 바디, 클라이언트 코드에 절대 출력하지 않음. 환경 변수로만 관리.
• 환불/취소 작업은 실행 전 Master 확인 — stripe.refunds.create(), 구독 cancel() 등 금전 영향 작업은 실행 전 Master 명시적 승인 필수. 자동화 스크립트에서 이 작업 단독 실행 금지.