토스페이먼츠, SDK V2로 결제 연동 경험을 혁신하다!
by DD
6개월 전
조회수 9
결제 SDK 개발 시, 안정성, 확장성, 명확성 확보를 위해 V2 SDK를 개발함
Global Trace ID와 모니터링 CLI를 통해 결제 실패 원인을 빠르게 파악함
인터페이스 계약을 통해 SDK 명세를 관리하고, 유효성 검증 계층을 구축함
SDK 안정성 확보를 위한 노력
결제 SDK는 가맹점 환경에 의존적이므로 예측 불가능한 문제가 발생한다. 따라서 단위 테스트 300개 이상과 E2E 통합 테스트 500개 이상을 구축했다. ElasticSearch 기반의 대시보드와 알림 시스템을 통해 장애 감지 및 복구 능력을 향상시켰다.
확장성을 위한 조립 가능한 SDK 설계
가맹점별 요구사항 대응을 위해 조립 가능한 SDK 아키텍처를 도입했다. Public Interface Layer, Domain Layer, External Service Layer로 계층을 분리하고, 각 레이어 간 인터페이스 기반 의존성 주입을 통해 유연성을 확보했다. 결과적으로 커스터마이징 비용 절감을 달성했다.
인터페이스를 계약으로, 명확성 확보
SDK 인터페이스를 계약으로 정의하여 명확성을 높였다. Git을 통해 계약 변경 이력을 관리하고, 자동 문서 생성 시스템을 구축했다. 유효성 검증 계층을 통해 런타임 에러를 개선하여, 가맹점 개발자에게 향상된 연동 경험을 제공한다.
