커머스 정산 · 세금계산서 연동 (레거시 PHP)
PHPMySQL바로빌 API은행 자동확인 APIYoungcart / Gnuboard
맥락
회원이 직접 자기 실적과 포인트를 확인해야 하고, 사업자에게는 세금계산서가 자동으로 발행되어야 하는 커머스 시스템들을 오랫동안 다뤘습니다.
문제
화면이 틀리면 컴플레인이 들어오지만, 정산이 틀리면 돈 문제가 됩니다. 두 영역은 허용되는 오차가 완전히 다릅니다.
내린 결정
돈이 걸린 로직은 화면 로직과 분리해서 다뤘다
포인트 적립·차감과 정산 계산은 표시용 코드와 같은 층에 두지 않았습니다. 화면은 언제든 바꿔 달라는 요청이 오지만, 정산 로직은 바꾸려면 근거가 필요합니다.
세금계산서를 사람 손에서 뗐다
바로빌 API로 발행·사전발행·취소·잔액조회를 연동했습니다. 수기 발행은 건수가 늘어나는 순간 반드시 누락이 생깁니다.
입금 확인을 눈으로 대조하지 않게 했다
은행 자동확인 API를 붙여 입금 대사를 자동화했습니다. 운영자가 통장을 보며 주문과 대조하는 작업이 사라졌습니다.
내가 맡은 범위
- 백엔드 개발
- 외부 API 연동
- 정산 로직
- 레거시 유지보수
실제 산출물
- 세금계산서 발행·취소·잔액조회 API 연동
- 은행 입금 자동확인 연동
- 회원 오피스(myoffice)와 포인트·정산 로직
솔직하게 — 아직 못 한 것
구형 PHP 스택이고 지금 다시 만든다면 구조를 다르게 잡을 겁니다. 다만 세금계산서·입금대사·포인트 정산처럼 틀리면 안 되는 영역을 실제 운영 환경에서 다뤄 본 경험은 스택과 무관하게 남습니다.
이런 일이 필요하시면
지금 막힌 지점을 그대로 적어 보내주세요. 제가 할 수 있는 일과 없는 일을 먼저 구분해 답장드립니다.