KO/EN
← 글 목록으로

대학병원 결제 POS 연동과 예외 흐름 설계

읽는 시간 10분

서비스와 결제 흐름

Mirlink는 임플란트 진료정보를 블록체인에 저장하는 의료 서비스다. 환자는 카드를 하나 발급받고, 치과에서 임플란트 진료를 받으면 그 기록이 암호화되어 체인에 올라간다.

돈이 오가는 지점은 두 군데다.

  • 카드 발급: 환자가 처음 카드를 받을 때 한 번 낸다.
  • 진료비: 그 뒤로 우리 플랫폼에서 결제하는 건 실제 치과 진료비다. 병원 데스크의 POS 단말기로 결제한다.

그리고 진료기록은 결제가 끝나야 체인에 올라간다. 기록은 임시 저장 → 결제 완료 → 체인 등록 순서로 상태가 넘어간다. 결제 완료 상태가 되지 않으면 다음 단계로 못 간다.

처음 해본 POS 연동

결제는 NICE의 POS 단말기를 썼다. 웹 결제(PG)는 해봤지만 POS는 처음이었다.

구조는 이렇다. 카드 단말기는 병원 PC에 연결되고, PC에서 도는 NICE 데몬 프로그램이 단말기와 통신한다. 우리 웹은 이 데몬에 로컬 WebSocket으로 결제 요청을 보내고 결과를 받는다. 브라우저 안에서 결제창을 띄우는 PG와는 완전히 다른 세계다.

처음 설치하고 테스트할 때 꽤 헤맸다.

  • 받은 연동 문서가 실제 받은 제품이랑 다른 모델 기준이었다. 문서대로 해도 안 되는 게 당연했다.
  • 기본 구성품에 연결에 필요한 선이 빠져 있었다. 코드 문제인 줄 알고 한참 보다가, 물리적으로 연결이 안 돼 있었다는 걸 알았다.

웹만 하던 입장에서는 "하드웨어가 문제일 수 있다"는 선택지가 머릿속에 아예 없었다. POS 연동은 코드보다 장비와 문서가 맞는지부터 확인하는 게 먼저라는 걸 배웠다.

예외 케이스 정리

결제 자체도 단순하지 않았다. 진료비는 치아 단위로 판단하는데, 모든 진료가 과금 대상은 아니다.

  • 그 치아에 처음 임플란트를 심는 경우(최초 식립): 과금
  • 그 치아에 이전 기록이 하나라도 있는 경우 (재식립, 제거 등): 면제
  • 이전 기록도 없고 식립도 아닌 경우: 과금 대상 아님

그래서 등록할 때 환자의 기존 기록을 치아별로 보고, 이번 진료가 과금인지 면제인지 판단한다. 면제만 있는 진료라면 결제 단계를 건너뛴다.

여기까지는 일반 치과 기준이다. 문제는 대학병원이었다.

대학병원은 수납을 따로 하지 않는다

타이밍도 좀 그랬다. MVP에서 프로덕션으로 넘어오면서 결제·정산 방식이 기존 기획에서 싹 바뀌었고, 그에 맞춰 구조를 한 번 갈아엎은 참이었다. 새 구조와 프로세스를 다 만들어 놓은 상태에서 기획자에게 요청이 하나 왔다.

"대학병원은 결제 안 해도 되게 해주세요."

대학병원은 진료비를 진료 건마다 개별적으로 수납하지 않는다. 병원 자체의 수납 체계가 따로 있어서, 우리 POS로 진료비를 결제하는 단계가 애초에 성립하지 않는다. 그러니 요청 자체는 자연스럽다.

큰 문제라기보다는 다 만들어 놓은 흐름에 예외 케이스가 하나 추가되는 상황이었다. 다만 그냥 결제만 빼면 끝나는 일은 아니었다. 지금 구조에서는 결제가 없으면 기록이 결제 완료 상태가 되지 못하고, 체인에도 못 올라간다.

3가지 옵션으로 구조화하기

요청은 한 줄이었지만, "결제를 안 한다"를 구현하는 방법은 여러 가지다. 어떤 걸 고르느냐에 따라 화면도, 상태 흐름도, 나중에 남는 기록도 달라진다. 그래서 바로 만들지 않고, 먼저 현재 결제 프로세스 흐름을 정리해서 공유한 다음 그 위에서 대학병원 케이스를 3가지 옵션으로 나눠 제시했다.

  1. 같은 프로세스, 결제 금액만 0원 — 흐름은 일반 병원과 똑같이 가고, 대학병원은 0원으로 결제를 완료한다.
  2. 같은 프로세스, 면제 안내 — 흐름은 같되, 결제 단계에서 "면제 대상"으로 안내하고 넘어간다.
  3. 결제 버튼으로 바로 등록 — 진료정보를 고르는 단계 없이, 결제 버튼을 누르면 전체 기록을 즉시 체인에 등록한다.

옵션마다 바뀌는 화면과 상태 흐름이 다르니까, 기획자는 서비스 관점에서 고르기만 하면 되도록 만드는 게 목표였다.

기획자와 협업 — 미리 알리고, 되묻기

이 프로젝트는 전문 기획자와 처음 같이 한 프로젝트였다. 기획자가 방향을 주면 나는 구현 옵션을 만들어 결정하기 쉬운 형태로 돌려주는 방식으로 일했다.

그리고 질문을 정말 많이 했다. 큰 결정보다는 자잘한 것들이 대부분이었다. 기획서에 없는 빈칸이 보이면 내가 임의로 채우지 않고 질문으로 돌려줬다. 예를 들면 이런 것들이다.

  • "복구 바코드 다운로드는 처음 한 번만인가요?"
  • "비밀번호 재설정 로직도 추가될 예정인가요?"

기술 제약도 먼저 말했다. 예를 들어 카드 분실에 대비한 복구 바코드를 환자가 내려받게 했는데, 실제로 갤러리에 저장됐는지까지는 웹에서 확인할 수 없다. 이런 건 나중에 "왜 확인이 안 되죠?"가 나오기 전에 미리 말해두는 게 낫다.

하나하나는 사소해 보여도, 개발자가 혼자 정한 빈칸은 나중에 기획과 어긋나기 쉽다. 질문 하나로 막을 수 있으면 그게 제일 싸다.

결정과 결과 — 0원 결제

결론은 1번, 0원 결제였다.

대학병원은 결제 금액에 0원을 입력할 수 있고, 0원이면 POS 단말기를 거치지 않고 바로 결제 완료로 처리한다. 결제 원장에는 대학병원 0원 결제라는 표시와 함께 0원짜리 결제 기록이 남고, 진료기록은 일반 병원과 똑같이 결제 완료 → 체인 등록으로 넘어간다.

이 방식이 좋았던 이유는 이렇다.

  • 상태 흐름을 건드리지 않는다. 대학병원이라고 "결제 없이 체인 등록" 같은 예외 경로를 만들지 않았다. 체인 등록 쪽 코드는 그대로다.
  • 기록이 남는다. 결제를 건너뛰는 게 아니라 0원 결제를 남기니까, 나중에 정산이나 내역을 볼 때 "이 기록은 왜 결제가 없지?"가 생기지 않는다.
  • 서버에서 한 번 더 막는다. 0원 결제는 서버에서 병원 유형을 다시 확인해서, 대학병원이 아니면 거절한다. 화면에서 0원을 입력해도 일반 병원은 통과하지 못한다.

돌아보면 이 일에서 중요했던 건 0원이라는 답보다 답을 고르는 방식이었다. 흐름을 먼저 보여주고, 선택지를 나누고, 제약은 미리 말하고, 빈칸은 되묻는 것. 예외 케이스는 결국 또 나온다. 그때마다 예외 경로를 새로 파는 대신 기존 흐름 안에 들어가게 만드는 것이 다음 예외를 쉽게 만든다.