DEV ZZAME logoDEV ZZAME
Back To Projects

Project Archive

전자계약서 연동 및 자동화

빠른정산 서비스 신청 고객이 계약서를 직접 출력하고 서명하는 방식은 처리 속도와 편의성 측면에서 한계가 있었음.

JavaSpring BootMariaDBAWSDocker

Why

  • 빠른정산 서비스 신청 고객이 계약서를 직접 출력하고 서명하는 방식은 처리 속도와 편의성 측면에서 한계가 있었음.
  • 전자계약서 도입을 통해 계약 체결 과정을 디지털화하고, 후속 프로세스와의 자동 연계를 실현하고자 했음.
  • 여러 마켓에서 수집된 정산 데이터의 구조가 마켓마다 달라, 이를 채권 가능 금액으로 통합 가공하는 정합 엔진이 필요했음.
  • 정합된 데이터를 기반으로 금융사와의 자금 조달 및 고객 지급까지 이어지는 end-to-end 지급 시스템 구축이 목표였음.

Challenge

  • 마켓별 전용 계약서 템플릿 관리: 쿠팡, 토스페이먼츠 등 마켓별로 계약 조건이 달라 각각 별도의 계약서 템플릿을 관리하고 자동으로 적용하는 로직이 필요했음.
  • 서명 완료 후 프로세스 자동 연계: 고객 서명 완료 시 계약 상태를 자동으로 변경하고 운영자에게 즉시 알림이 전달되어야 했음.
  • 마켓별 복잡한 상계 구조 처리: 쿠팡 로켓의 경우 광고비, 성장장려금, 밀크런, 프리미엄 등 10개 이상의 상계 항목이 존재하여 각각의 처리 로직을 개별적으로 설계해야 했음.
  • 채권 유효성 실시간 검증: 삭제 채권, 중복 채권, 압류·보류 상태의 채권을 자동으로 감지하고 처리하는 로직이 필요했음.
  • 금융사 연동 및 상환 관리: 금융사 서버와 데이터를 주고받고, 지급·상환·수수료 정산까지 트랜잭션 단위로 정확하게 관리해야 했음.

To Be

  • SignOK API 연동 및 마켓별 템플릿 자동 적용: SignOK API를 연동하여 전자계약서를 생성하고, 마켓 유형에 따라 해당하는 계약서 템플릿이 자동으로 선택되어 적용되도록 구현함.
  • 웹훅 기반 서명 완료 자동화: SignOK 웹훅을 활용하여 고객 서명 완료 이벤트를 실시간으로 수신하고, 계약 상태를 자동으로 업데이트함. 운영자에게는 Slack 알림을 전송하여 후속 서명 절차를 지체 없이 진행할 수 있도록 함.
  • 통합 정산 정합 엔진 구현: 마켓별 정산 데이터를 파싱하고 상계 항목을 차감하여 채권 가능 금액을 산출하는 정합 엔진을 구현함. 중복·삭제 채권 감지 로직과 Slack 알림을 연동하여 이상 채권 발생 시 즉각 대응할 수 있도록 함.
  • 지급 시스템 및 금융사 연동 구축: 정합 데이터를 기반으로 고객 지급 프로세스를 자동화하고, 금융사 서버와 RestTemplate 기반 RESTful API로 연동하여 자금 조달·상환·수수료 처리를 트랜잭션 단위로 관리함. 예금주 확인 API(쿠콘)를 연동하여 착오송금을 사전 차단하는 계좌 검증 프로세스도 추가함.