PG사 결제 승인 요청이 타임아웃이 났을 때 대응하기
·
서버
들어가며저는 실시간 AI 회의록 서비스 HeyMoa를 개발하고 운영하고 있습니다. 유료 요금제 PRO의 월 구독 기능을 구현하면서, PG사에 보낸 결제 승인 요청에서 타임아웃이 발생하면 어떻게 해야 할지 고민하게 됐습니다. 승인 요청을 보냈는데 응답이 오지 않으면 서버는 결제가 됐는지 알 수 없습니다. 실패로 처리하면 돈을 낸 고객이 PRO를 받지 못하고, 다시 보내면 같은 결제가 두 번 청구될 수 있습니다. 이럴 때 서버는 무엇을 해야 할까요? 이 글에서는 나이스페이 포스타트에서 응답을 잃은 승인을 조회로 어떻게 확인했고, 놓친 승인을 PG사 거래 목록과 매일 맞춰 보는 거래 대사로 어떻게 찾았는지, 그렇게 정하기까지 고민한 것들을 적어 보겠습니다. 이 글의 나이스페이는 나이스페이 포스타트를 가리킵니다..
PG사 빌링키로 월 구독 정기결제 구현하기
·
서버
들어가며저는 실시간 AI 회의록 서비스 HeyMoa를 개발하고 운영하고 있습니다. 녹음 사용량을 기준으로 요금제를 FREE와 PRO 두 계층으로 나누면서, 유료 요금제 PRO의 월 구독 기능을 나이스페이 포스타트의 빌링키로 구현했습니다. 구독은 팀이 회의록을 함께 쓰는 공간인 워크스페이스 단위로 정했습니다. 관리자가 카드를 한 번 등록하면 PG사(카드 결제를 대신 처리하는 결제 대행사)에서 빌링키(카드 정보 대신 매달 결제에 쓰는 키)를 받아 두고, 서버가 매달 그 빌링키로 결제를 요청하도록 했습니다. 그 결과에 따라 워크스페이스가 PRO와 FREE 사이를 오가도록 했습니다. PG사는 결제 한 건을 승인하는 API까지만 제공합니다. 구독이 언제 시작되고 끝나는지, 결과를 기다리는 동안이나 결제가 거절됐을..
컬럼 타입 변경으로 조회가 실패한 뒤 돌아본 Expand–Contract 패턴
·
서버
저는 실시간 AI 회의록 서비스 HeyMoa를 개발하고 운영하고 있습니다. Spring과 JPA, PostgreSQL을 사용하며 AWS ECS에서 서버를 롤링 배포하고 있습니다. 프로필 이미지 URL을 저장하는 컬럼을 VARCHAR(255)에서 TEXT로 변경했습니다. 더 긴 문자열을 저장하려는 수정이었고, 기존 값도 그대로 담을 수 있으니 조회에는 문제가 없을 것으로 생각했습니다. 하지만 배포 뒤 일부 조회 요청이 실패했습니다. 문자열 길이 제한을 푸는 작은 변경이라고 생각했지만, 기존 조회에 미칠 영향을 놓쳤습니다. 원인을 따라가 보니 기존 DB 세션에 남은 prepared statement가 문제였습니다. 이 글에서는 컬럼 타입 변경이 조회 실패로 이어진 원인을 살펴보고, 이를 계기로 다시 돌아본 ..
AI 에이전트와 서비스를 개발하고 운영하며 내가 배운 것들
·
회고
2026년 4월 이전에는 무료 ChatGPT와 Claude Pro, Gemini 등을 사용했다. 당시에는 AI 도구에 구독료를 더 쓰기가 아까웠다. 지금 돌아보면 치킨 몇 번 덜 먹고 더 써 볼 걸 싶기도 한다. 제한된 사용량 안에서 개발하다 보니 AI에 어디까지 맡길 수 있는지도 실감하지 못했다. AI 소프트웨어 마에스트로 17기에 참여하면서 AI를 활용하는 범위를 넓혀 보게 됐다. 2026년 5월부터 여러 기업의 CTO와 개발자, 마케터, 팔란티어와 협업하는 실무자 등 현업 멘토들의 특강을 들었다. 인상 깊었던 것은 AI를 코드 작성에만 쓰지 않는다는 점이었다. 개발팀이 아닌 다른 분야의 팀에서도 업무에 필요한 도구를 직접 만들어 쓰고 있었다. 나는 주로 코드를 작성하거나 오류를 해결할 때 AI를 썼..
Realtime Gateway 분리를 위한 Valkey ticket 인증 설계
·
서버
저는 실시간 AI 회의록 서비스 HeyMoa를 개발하고 운영하고 있습니다. REST API와 realtime gateway의 배포를 분리하기 위해 WebSocket 접속에 Valkey 기반 일회용 ticket을 선택한 이유와 인증 흐름을 정리했습니다. 브라우저에서 보낸 음성을 글로 옮기고 회의가 진행되는 동안 스크립트와 분석 결과를 보여 줍니다. 음성과 전사 결과를 계속 주고받는 데는 WebSocket을 사용합니다. 기존 구조에서는 REST API와 WebSocket을 한 서버에서 제공하고 같은 로그인 쿠키로 사용자를 확인했습니다. WebSocket 연결을 유지하는 realtime 서버는 별도로 배포하기로 정했습니다. API와 realtime 서버를 따로 배포하려면 로그인과 권한 확인을 어느 쪽에서 담당..
Spring WebSocket의 Inbound Channel에 가상 스레드 적용하기
·
서버
저는 실시간 AI 회의록 서비스 HeyMoa를 개발하고 운영하고 있습니다. Spring WebSocket의 STOMP 메시지 처리 경로와 Inbound Channel에 가상 스레드를 적용한 이유, 순서 보장과 한계를 정리했습니다. 회의 중에는 브라우저에서 보낸 음성을 서버가 받아 전사 업체로 전달하고, 스크립트와 분석 결과를 다시 화면에 보여 줍니다. 이때 음성과 메시지를 계속 주고받기 위해 WebSocket과 STOMP를 사용합니다. 같은 연결로 들어오는 메시지라도 처리 내용은 다릅니다. 음성 조각은 주로 저장과 전사를 맡은 작업의 큐에 넘기지만, 녹음 연결을 준비할 때는 DB에서 세션을 확인하고 녹음을 끝낼 때는 남은 음성의 저장과 전사 마무리를 기다립니다. Spring은 받은 메시지를 clientI..