등록비 결제 시스템 개발 인수인계 부담을 없애는 유지보수 구조

수동 운영의 늪에서 벗어나는 모듈화 구조 설계

매년 학술대회 준비 시즌이 되면 가장 먼저 발목을 잡는 게 결제 금액과 할인 일정 변경이다. 작년 담당자가 퇴사했고, 작년에 쓰던 시스템에서 조기등록 마감일을 바꾸려니 개발사에 연락해야 한다. "3일만 수정해 달라"고 요청했지만, 개발사 일정이 밀려 있어 조기등록 마감이 지나도 변경이 안 되는 경험, 한 번쯤 있을 것이다.

하드코딩이 만드는 연쇄 고립

문제의 핵심은 요금 정책이 소스코드 안에 고정되어 있다는 점이다. 정회원·준회원·학생회원별 금액, 조기등록 할인 구간, 가상계좌 입금 기한이 코드로 묶여 있으면, 행사 때마다 개발자의 키보드를 기다려야 한다. 담당자가 바뀌면 상황은 더 악화한다. 전임자가 어떤 조건으로 요금을 세팅했는지 문서조차 남아 있지 않기 때문이다.

모듈화가 풀리는 연쇄 자동화

PG사 교체·서버 이전 시 소스코드 충돌 막는 아키텍처

결제 연동 로직이 소스코드와 뒤엉키면 생기는 일

학회 등록 시즌이 아닌 평소에는 아무 문제 없이 돌아가던 결제 페이지가, PG사를 바꾸거나 서버를 옮기는 순간 전체가 멈춰버린다. 가장 흔한 원인은 하나다. 토스페이먼츠나 NICEPAY 연동 코드가 결제 페이지 HTML, 회원 등급별 요금 계산 로직, 접수 데이터 처리까지 하나의 소스코드 덩어리로 뒤엉켜 있는 구조다. 이 상태에서 PG사의 API 스펙이 바뀌거나 계약을 다른사로 이전하면, 연동 코드를 건드리는 순간 등록 폼도, 요금 계산도, 알림톡 발송도 함께 깨진다. 결제만 고치려다 학회 전체 등록 시스템이 마비되는 것이다.

올바른 구조는 결제 연동 로직을 독립된 층으로 빼내는 것이다. 사전등록 폼, 정회원·준회원·학생회원 등급별 요금 자동 계산, 조기등록 할인 적용, QR 바우처 발송 — 이런 학회 운영 기능과 PG사 연동 코드가 물리적으로 분리되어 있어야 한다. 이렇게 설계되면 PG사 교체 시 API 키만 교체하면 된다. e-Regi는 NICEPAY·토스페이먼츠를 통해 신용카드, 카카오페이, 네이버페이, 가상계좌를 실시간 연동하면서도, 이 결제 연동층이 등록 페이지나 회원 DB와 직접 결합하지 않는 형태로 운영된다.

[비교] 기존 하드코딩 결제 vs 관리자 페이지 기반 모듈형 결제

현장에서 벌어지는 일

학회 등록비를 올리거나 조기등록 마감일을 연장해야 할 때, "개발사에 연락할 수 있나? "가 첫 번째 질문이라면 이미 구조가 잘못된 것입니다. 금액과 기간이 소스코드에 고정되어 있으면 수정마다 개발사 일정을 기다려야 하고, 그 사이 참가자는 이전 금액을 결제하거나 오류 화면을 만나게 됩니다. 관리자 페이지 기반 모듈형 결제는 담당자가 직접 금액·기간·할인 조건을 입력하고 저장하면 즉시 반영됩니다. e-Regi가 정회원·준회원·학생회원 등급별 요금을 자동 계산하고 조기등록 할인을 자동 적용하는 구조라면, 등급 체계나 금액이 바뀌어도 코드 수정 없이 관리자 화면에서 처리할 수 있습니다.

퇴사·부서 이동 시 보안 권한 승계와 개발사 인계 필수 항목

가장 흔한 사고 패턴은 담당자가 퇴사한 다음 날, 결제 오류가 났을 때 PG사 관리자 페이지에 들어갈 수 없는 상황이다. 로그인 아이디가 전임자의 개인 이메일로 가입되어 있고, 2단계 인증 문자도 그 사람의 번호로 가니, 신규 담당자는 정상 결제 내역조차 확인하지 못한다. API 키, 서버 접속 계정, PG사 관리자 권한이 개인 자격증명에 묶여 있으면, 그 사람이 떠나는 순간 시스템 전체가 멈춘다. 이걸 사전에 막으려면 인계 시점이 아니라 최초 구축 시점부터 공식 계정 기반으로 분리해두어야 한다.

학회 행사 인수인계 장애 사례와 예방 체크리스트 + 맺음

전임자가 떠난 뒤, 가장 먼저 무너지는 것

환불 요청이 들어왔는데 결제 내역이 보이지 않는다. 행사 당일 갑자기 결제 오류가 발생했지만, 시스템을 설정한 담당자는 이미 퇴사한 뒤다. 연락처도, 관리자 계정도, 결제 대행사가 어디인지조차 문서로 남아 있지 않아 후임자는 아무것도 할 수 없다. 학회 행사 인수인계에서 가장 많이 신고되는 장애가 바로 이 패턴이다.

문제의 핵심은 "사람이 기억하는 운영"이다. 전임자의 머릿속에만 결제 흐름, 환불 규칙, 알림 발송 시점이 있으면, 그 사람이 사라지는 순간 시스템도 함께 멈춘다.

인수인계 장애를 막는 예방 체크리스트

아래 항목을 점검해 보자.

• 결제 내역을 조회할 수 있는 관리자 대시보드 접속 경로가 문서화되어 있는가
• 환불 처리 권한과 절차가 후임자에게 전달되어 있는가
• 행사 당일 결제 오류 발생 시 연락할 담당자·업체 연락처가 보드에 게시되어 있는가
• 참가자에게 발송된 QR 바우처 발송 이력을 추적할 수 있는가
• 행사 종료 후 엑셀 보고서 내보내기 경로를 후임자가 재현할 수 있는가

하나라도 "모르겠다"면, 이미 인수인계 리스크가 쌓이고 있다.