***

title: 토스페이먼츠 SDK v2를 소개합니다
description: 토스페이먼츠 SDK v2 를 소개합니다. v1 에서 결제・브랜드페이・결제창으로 나뉘어 있던 SDK 를 하나로 합쳤어요. 무엇이 어떻게 바뀌었고 왜 그렇게 만들었는지 이야기해볼게요.
keyword: SDK, v2, 버전 2, 결제위젯, 브랜드페이, 결제창, 빌링, 자동결제
publishedAt: 2024-7-9
thumbnailSrc: https://static.tosspayments.com/docs/blog/tosspayments-sdk-v2-main.png
------------------------------------------------------------------------------------

# 토스페이먼츠 SDK v2를 소개합니다

2024년 7월 9일 ・ 읽는 시간 3분

![토스페이먼츠 SDK v2를 소개합니다](https://static.tosspayments.com/docs/blog/tosspayments-sdk-v2-main.png#2616x1536)

2020년 출범 이후, 토스페이먼츠는 국내에서 볼 수 없었던 결제 서비스를 제공해왔어요. 한 번 연동하면 노코드로 결제 UI를 커스터마이징할 수 있는 [결제위젯](/guides/v2/payment-widget), 최소한의 비용으로 '자체 페이 시스템'을 만들 수 있는 [브랜드페이](/guides/v2/brandpay)는 이제 국내 온라인 결제 시장에서 대체 불가능한 서비스로 자리매김했죠.

지금까지는 온라인 사업자의 어려움을 직접 겪어보면서 간편하고 편리한 연동 서비스를 제공하는 데 집중했다면, 앞으로는 **더욱 안정적이고 통일된 인터페이스를 만들어서 이해하기 쉽고 편리한 토스페이먼츠 연동 경험**을 강화하겠습니다.

### 토스페이먼츠 SDK의 새로운 기능

이런 목표의 첫걸음으로 토스페이먼츠 SDK Version 2를 출시했어요. 결제 연동을 처음 해보는 개발자도 쉽게 연동할 수 있는 안정적인 결제 SDK입니다.

1. **모든 결제 서비스 하나의 SDK로**

   이전에는 결제위젯, 브랜드페이, 결제창 등 토스페이먼츠 결제 서비스를 연동할 때는 각 다른 SDK를 설치하고 초기화해야 됐습니다. 이런 불편함은 토스페이먼츠 SDK Version 2에 해소됐어요. 하나의 SDK를 설치하고 초기화하면 토스페이먼츠의 모든 제품을 바로 사용할 수 있습니다.

2. **이해하기 쉽고 통일된 인터페이스**

   토스페이먼츠 SDK Version 2에서는 모든 결제 서비스가 하나의 SDK로 통합되면서 파라미터의 타입, 동작 범위 등 모두 통일됐어요. 하나의 결제 서비스 연동을 마치면, 손쉽게 다른 결제 서비스도 연동할 수 있어요. 모호하고 헷갈릴만한 동작을 모두 개선해서 더욱 편리하고 빠른 결제 연동 경험을 만들었어요.

3. **편리한 개발 및 디버깅 경험**

   연동 과정에서 겪는 에러 코드 및 메시지가 더욱 명확해졌습니다. 토스페이먼츠 SDK Version 2에서는 올바르지 않은 방법으로 연동하면 빠르게 에러 메시지로 피드백을 받을 수 있어요. 예를 들어 필수 파라미터가 누락된 경우, 타입이 잘못된 경우 등 다양한 에러 상황에서 명확한 피드백을 받을 수 있어요. 명확하고 빠른 피드백으로 개발 경험과 생산성이 크게 향상됐어요.

토스페이먼츠 SDK Version 2 레퍼런스

### 지원하는 결제 서비스 및 수단

토스페이먼츠 SDK Version 2는 결제위젯, 브랜드페이, 결제창(일반결제, 자동결제) 결제 서비스를 지원하고 있어요. 각 결제 서비스에서 지원하는 결제수단은 다음과 같습니다.

| 결제 서비스                               | 일반 결제            | 해외 간편결제 | 자동결제(빌링)   |
| ----------------------------------------- | -------------------- | ------------- | ---------------- |
| [**결제위젯**](/guides/v2/payment-widget) | ✅ 모든 결제수단     | ✅ PayPal     | ❌               |
| [**브랜드페이**](/guides/v2/brandpay)     | ✅ 카드 및 계좌 결제 | ❌            | ❌               |
| [**결제창**](/guides/v2/payment-window)   | ✅ 모든 결제수단     | ✅ PayPal     | ✅ 카드 자동결제 |

\* 모든 결제수단: 카드, 간편결제, 가상계좌, 계좌이체, 휴대폰, 상품권

![결제 서비스 이미지](https://static.tosspayments.com/docs/blog/tosspayments-sdk-v2-payment-services-2.png#3000x1240)

결제위젯 연동 가이드