안녕하세요, 토스페이먼츠 Server Developer 허지훈입니다.
온라인에서 ‘구매하기’ 버튼을 누르는 그 순간, 사용자는 단 몇 초 만에 결제가 완료되는 경험을 합니다. 하지만 그 짧은 순간 동안, 서버와 서버 사이에서는 수많은 API 호출이 오가며 결제를 처리하고 있죠. 결제창을 띄우는 것부터 승인 요청, 결제 완료, 정산, 그리고 금액 검증까지. 이 모든 과정은 API를 통해 연결됩니다.
토스페이먼츠는 이런 흐름의 중심에서 가맹점이 결제 서비스를 연동할 수 있도록 Open API를 제공합니다. 현재 토스페이먼츠의 Open API는 20만 개 이상의 가맹점에서 사용되고 있습니다. 이 수치는 단순히 규모를 넘어, API가 얼마나 오랫동안 안정적으로 운영되어야 하는지를 보여줍니다. 한 번 연동된 API는 수년, 혹은 수십 년 동안 유지될 수 있고, 잘못 설계된 API 하나는 그만큼의 시간 동안 불편과 유지 비용을 낳습니다.
그래서 토스페이먼츠는 Open API를 단순히 잘 동작하는 것을 넘어, 앞으로 수십 년간 안전하게 운영될 인프라라는 관점에서 설계하고 관리하고 있습니다. API는 단순한 통신 수단이 아니라, 토스페이먼츠와 가맹점이 안정적으로 연결될 수 있는 기반이기 때문입니다.
그렇다면 수십만 개의 가맹점이 사용하는 Open API를 오랫동안 안정적으로 운영하기 위해서는 어떤 것들을 고려해야 할까요?
API 설계 방식은 어떻게 정하고, 외부 개발자에게는 어떤 환경을 제공해야 할까요?
보안은 어떻게 보장하고, 내부적으로는 품질을 어떻게 유지할까요?
토스페이먼츠는 이러한 고민을 다섯 가지 핵심 요소로 정리했습니다.
Open API의 5가지 핵심 요소
1. 인터페이스 – API와 웹훅, 어떻게 데이터를 주고받을 것인가
2. 외부 생태계(개발자 경험) – 문서, 테스트 환경, 도구로 완성하는 개발 여정
3. 보안 – 인증, 서명, 암호화로 지키는 안전한 시스템
4. 안정성 – 고가용성 인프라와 모니터링 체계
5. 내부 생태계 – 조직 차원의 API 품질 관리과 운영 프로세스
1.
1. 인터페이스 – API와 웹훅, 어떻게 데이터를 주고받을 것인가
2.
2. 외부 생태계(개발자 경험) – 문서, 테스트 환경, 도구로 완성하는 개발 여정
3.
3. 보안 – 인증, 서명, 암호화로 지키는 안전한 시스템
4.
4. 안정성 – 고가용성 인프라와 모니터링 체계
5.
5. 내부 생태계 – 조직 차원의 API 품질 관리과 운영 프로세스
이번 글에서는 이 중에서 ‘안정성’을 제외한 네 가지 요소, 인터페이스, 외부 생태계, 보안, 내부 생태계에 대해 이야기하려고 합니다. 토스페이먼츠가 Open API를 어떻게 바라보고, 어떤 방식으로 발전시켜 나가고 있는지를 함께 살펴보겠습니다.