---
id: wiki-2026-0508-토스-toss-front-sdk-퍼사드-패턴-적용
title: 토스(Toss) Front SDK 퍼사드 패턴 적용
category: 10_Wiki/Topics
status: duplicate
canonical_id: 퍼사드-패턴-facade-pattern
duplicate_of: "[[퍼사드 패턴 (Facade Pattern)]]"
aliases: []
source_trust_level: A
confidence_score: 0.9
verification_status: redirected
tags: [duplicate, facade, sdk, toss]
last_reinforced: 2026-05-10
github_commit: pending
---

# 토스(Toss) Front SDK 퍼사드 패턴 적용

> **이 문서는 [[퍼사드 패턴 (Facade Pattern)]] 의 specialization (case study) 입니다.** 매 일반 원리는 canonical 문서로 redirect.

## 핵심 요약 (Toss-specific aspects)
- 매 Toss Front SDK 는 매 결제/인증/송금 의 매 multiple subsystem 을 매 단일 `TossPayments(clientKey)` facade 의 의해 노출.
- 매 internal: `widgets()`, `requestPayment()`, `requestBillingAuth()` 등 매 5+ subsystem 을 매 thin wrapper.
- 매 client 는 매 PG / 카드사 / 인증 routing 의 details 를 매 의식 X.
- 매 versioning: SDK v2 (2024) → v3 (2026) 매 breaking change 의 facade level 만 흡수, internal 은 매 free 변경.
- 매 trade-off: 매 facade 의 단순함 vs 매 customization 한계 (escape hatch 제공).

## 🔗 Graph
- 부모: [[퍼사드 패턴 (Facade Pattern)]] (canonical)
- Adjacent: [[Front SDK 설계]] · [[PG (Payment Gateway) 추상화]]

## 🕓 변경 이력
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | 중복 처리 — Facade Pattern canonical 문서로 redirect |
