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

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

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

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

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

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

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

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

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

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

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

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