결제 화면까지 열리면 끝인 줄 알았습니다 — Stripe에서 Lemon Squeezy로 바꾸고 Free를 Pro로 연결한 과정
2026.08.11

K-드라마 음식 검색 MVP에 Google 로그인과 해외 구독을 붙이면서, 결제 제공자 변경부터 웹훅 서명 오류와 잔류 서버 문제까지 해결한 기록
테스트 결제 화면에는 “결제와 주문 모두 마쳤습니다”라고 나왔습니다. 그런데 K-Food Lens 계정은 계속 Free였습니다.
결제는 성공했지만 서비스에는 반영되지 않은 것입니다.
처음에는 웹훅 Signing secret를 잘못 입력했다고 생각했습니다. 대시보드와 로컬 설정을 다시 맞추고 이벤트를 재전송했지만 결과는 계속 400 INVALID_WEBHOOK_SIGNATURE였습니다. 몇 번을 확인한 뒤에야 진짜 원인을 찾았습니다. 이전 secret를 읽은 Node 서버가 종료되지 않은 채 4173 포트를 계속 점유하고 있었습니다.
이 글은 K-드라마 음식 검색 MVP에 Google 로그인과 해외 결제를 붙이면서 겪은 시행착오를 정리한 후속편입니다. Stripe 가입 화면에서 막혀 Lemon Squeezy로 결제 시스템을 바꾼 과정, 로컬 서버에 외부 웹훅을 연결한 방법, 그리고 결제 성공 화면이 아니라 실제 계정의 Free → Pro 전환까지 확인한 과정을 담았습니다.
바쁘시면 이것만 보세요
기존 K-Food Lens에 이메일 로그인과 함께 Google 간편 로그인을 추가했습니다.
Google 로그인은 코드·클라이언트 설정·자동 테스트까지 완료했지만 실제 계정 선택 후 로그인되는 브라우저 최종 검증은 남아 있습니다.
Stripe로 해외 구독 결제를 붙이려 했지만 한국 판매자 조건으로 진행하는 국가 선택 단계에서 막혔습니다.
지원되지 않는 국가를 임의로 선택하지 않고 Merchant of Record 방식의 Lemon Squeezy로 바꿨습니다.
월 ₩9,900 테스트 구독 상품과 Hosted Checkout을 만들었습니다.
Cloudflare Quick Tunnel로 로컬 웹훅을 외부 HTTPS 주소에 연결했습니다.
테스트 결제는 성공했지만 웹훅 서명 오류 때문에 계정이 계속 Free로 남았습니다.
실제 원인은 secret 문자열이 아니라 이전 환경변수로 살아 있던 Node 서버였습니다.
이전 서버를 종료하고 실제 웹훅을 재전송한 뒤 계정이
Pro · ₩9,900/month와 무제한 검색으로 바뀌었습니다.자동 테스트는 최종 30/30 통과했습니다.
지금까지 검증한 것은 테스트 결제입니다. 실제 판매를 시작하려면 Lemon Squeezy 판매자 심사와 스토어 활성화가 필요합니다.
이런 분들께 도움이 됩니다
이미지 인식 데모를 로그인·구독이 있는 SaaS MVP로 확장하려는 분
한국 판매자 입장에서 해외 결제 제공자를 비교하는 분
Checkout은 성공했는데 서비스 권한이 바뀌지 않아 막힌 분
로컬 개발 서버에서 외부 웹훅을 테스트하려는 분
AI와 함께 개발하되 결제·비밀정보·사람 승인 경계를 어떻게 나눌지 고민하는 분
시작점: 기능은 있었지만 실제 서비스 흐름은 덜 끝나 있었습니다
기존 K-Food Lens는 K-드라마 장면을 붙여넣으면 로컬 비전 모델이 한국 음식이나 조리 장면을 설명하고, 소스나 간편식 검색으로 연결하는 웹 MVP였습니다.
초기에는 떡볶이, 라면, 비빔밥, 김치찌개, 한국식 치킨 다섯 종류 중 하나를 고르는 구조였습니다. 샘플에서는 그럴듯했지만 불판 위 고기를 라면 77.7%로 답하는 실패를 겪었습니다. 이후 Ollama의 qwen2.5vl:7b로 바꾸고, 음식명뿐 아니라 보이는 근거와 불확실성을 함께 보여주는 구조로 다시 만들었습니다.
화면도 베이지·세리프 중심의 초기 디자인에서 시스템 폰트, 넓은 여백, 하나의 주요 액션 색을 사용하는 구조로 정리했습니다. 이미지 파일을 찾아 올리는 불편을 줄이기 위해 캡처 후 Ctrl+V 또는 ⌘+V로 바로 붙여넣는 기능도 추가했습니다.
여기까지 만들고 발표 자료를 정리하면서 마지막 슬라이드에 이렇게 적었습니다.
이번 주에는 최종본을 만들고 해외 결제 시스템을 붙이겠습니다.
이 문장을 계획으로만 남기지 않고 실제로 실행해보기로 했습니다.
이번 확장의 성공 기준을 다시 정했습니다
결제 버튼이 보인다고 결제가 완성된 것은 아닙니다. 그래서 완료 조건을 다음처럼 나눴습니다.
로그인 버튼 표시
→ Google 계정 검증
→ 사용자 계정 생성 또는 연결
Upgrade 클릭
→ Hosted Checkout 진입
→ 테스트 주문·구독 생성
→ 실제 서명 웹훅 수신
→ 결제 사용자와 로컬 계정 매핑
→ Free에서 Pro로 권한 변경
→ 무제한 검색 표시특히 Checkout의 성공 URL만 보고 Pro 권한을 주지 않기로 했습니다. 브라우저 주소는 사용자가 바꿀 수 있기 때문입니다. 결제 제공자가 보낸 서명된 웹훅을 서버에서 검증한 뒤에만 구독 상태를 변경했습니다.
1단계: 이메일 로그인 옆에 Google 로그인을 추가했습니다
기존에는 이메일과 비밀번호로만 가입할 수 있었습니다. 해외 사용자가 처음 보는 서비스에서 비밀번호를 새로 만드는 부담을 줄이기 위해 Google Identity Services를 추가했습니다.
구조는 다음과 같습니다.
Google이 브라우저에 ID credential 전달
→ K-Food Lens 서버로 credential 전송
→ 서버가 Google 공개 키와 대상 client ID로 검증
→ 검증된 이메일로 신규 계정 생성 또는 기존 계정 연결
→ 기존과 같은 HttpOnly 세션 발급Google의 공개 웹 클라이언트 ID만 프런트에 전달하고, 별도의 Google client secret는 사용하지 않았습니다. 기존 이메일과 동일한 검증된 Google 이메일이면 계정을 중복 생성하지 않고 연결하게 했습니다.
자동 테스트에는 다음 상황을 넣었습니다.
처음 Google 로그인한 사용자의 계정 생성
같은 Google 계정으로 다시 로그인했을 때 기존 계정 재사용
이미 가입된 동일 이메일 계정과 연결
이메일 검증이 되지 않은 credential 거절
시행착오: OAuth 클라이언트를 찾을 수 없었습니다
처음 Google 버튼을 누르자 다음 오류가 나왔습니다.
액세스 차단됨: 승인 오류
The OAuth client was not found.
401 invalid_clientGoogle Cloud 설정을 처음부터 다시 만들기 전에 로컬 환경변수와 실제 클라이언트 ID를 비교했습니다. .env에 저장된 문자열 한 부분이 잘못되어 있었습니다. 값을 수정하고 서버를 재시작한 뒤 서버 설정에서는 Google 인증이 활성화된 것으로 확인됐습니다.
다만 이 글을 쓰는 시점에는 실제 브라우저에서 Google 계정을 선택해 새 세션이 만들어지는 최종 E2E 테스트가 남아 있습니다. 코드가 있고 자동 테스트가 통과했다고 해서 “Google 로그인 완료”라고 쓰지 않기로 했습니다.
현재 상태는 다음과 같습니다.
구분 | 상태 |
|---|---|
Google 로그인 UI | 완료 |
서버 credential 검증 코드 | 완료 |
신규 계정·기존 계정 연결 테스트 | 완료 |
공개 웹 클라이언트 ID 설정 | 완료 |
실제 Google 계정 선택 후 브라우저 로그인 | 최종 재검증 필요 |
2단계: Stripe를 붙이려다 판매자 국가에서 멈췄습니다
처음 결제 제공자로 선택한 것은 Stripe였습니다. 개발 문서가 많고 SaaS Checkout과 구독 웹훅 예제가 풍부했기 때문입니다. 코드에도 Stripe Checkout, 웹훅, 고객 포털 구조를 먼저 만들었습니다.
하지만 실제 판매자 계정을 만들려고 하자 한국 사업자 조건으로 진행하는 국가 선택 단계에서 막혔습니다.
여기서 선택지는 두 가지였습니다.
지원되지 않는 다른 국가를 선택해 계속 진행한다.
한국 판매자를 지원하는 다른 결제 구조를 찾는다.
첫 번째 방법은 선택하지 않았습니다. 가입 단계만 넘기더라도 나중에 사업자 확인, 세금, 정산 계좌, 신원 검증에서 더 큰 문제가 생길 수 있기 때문입니다.
결국 직접 결제 처리 회사 대신 Merchant of Record 역할을 하는 Lemon Squeezy로 전환했습니다. Lemon Squeezy가 판매 주체로 세금과 결제 처리를 맡고, 판매자는 디지털 상품이나 SaaS를 제공하는 구조입니다.
이 선택은 단순히 라이브러리를 하나 바꾸는 일이 아니었습니다.
Stripe 패키지 제거
Checkout 생성 방식 변경
웹훅 이벤트 이름 변경
고객·구독 식별자 저장 필드 변경
고객 포털 URL 처리 변경
환경변수와 테스트 변경
화면에 남은 Stripe·달러 가격 문구 제거
기존 코드를 억지로 유지하는 것보다 제공자에 맞게 결제 경계를 다시 정리했습니다.
3단계: 월 ₩9,900 구독 상품과 웹훅을 만들었습니다
Lemon Squeezy 테스트 모드에서 K-Food Lens Pro 상품을 만들고 월 ₩9,900 구독으로 설정했습니다.
Checkout 링크에는 로그인한 사용자를 찾기 위한 최소 정보만 추가했습니다.
로그인한 로컬 user_id
+ 결제 이메일
→ Lemon Squeezy Hosted Checkout
→ 웹훅 meta.custom_data로 user_id 반환카드 번호는 K-Food Lens가 받지 않습니다. 사용자는 Lemon Squeezy가 제공하는 Checkout에서 결제하고, 앱은 결제 결과 이벤트만 받습니다.
구독 상태 동기화를 위해 다음 이벤트를 연결했습니다.
구독 생성·업데이트·취소·재개·만료
구독 일시중지·재개
결제 성공·실패·회복
웹훅 요청은 JSON으로 파싱하기 전에 원본 바이트와 X-Signature 헤더를 HMAC-SHA256으로 검증했습니다. 서명이 틀리면 권한을 변경하지 않고 400으로 거절했습니다.
4단계: localhost에는 Lemon Squeezy가 들어올 수 없었습니다
앱은 localhost:4173에서 실행되고 있었습니다. 제 브라우저에서는 열리지만 Lemon Squeezy 서버는 제 Mac의 localhost에 접근할 수 없습니다.
그래서 Cloudflare Quick Tunnel을 사용했습니다.
Lemon Squeezy
→ 임시 공개 HTTPS 주소
→ Cloudflare Tunnel
→ localhost:4173/api/billing/webhook설정 후 다음 순서로 확인했습니다.
공개 주소의
/api/health가 외부에서 열리는지 확인서명 없는 웹훅 요청이 400으로 거절되는지 확인
로컬 secret로 만든 서명된 진단 요청이 200인지 확인
Lemon Squeezy 대시보드에서 실제 이벤트를 전송
임시 Tunnel 주소는 재시작할 때 바뀔 수 있습니다. 이번에는 로컬 테스트용으로만 사용했고, 실제 운영 전에는 안정적인 배포 주소로 교체해야 합니다.
5단계: 테스트 결제는 성공했는데 계정은 계속 Free였습니다
Hosted Checkout에서 Lemon Squeezy 공식 테스트 카드로 월 ₩9,900 결제를 진행했습니다.
결제 성공 화면만 보면 끝난 것처럼 보였습니다. Lemon Squeezy에도 테스트 주문과 구독이 각각 생성됐습니다.
그런데 K-Food Lens의 계정 상태는 이랬습니다.
plan: free
subscription_status: inactive
customer_id: missing
subscription_id: missing
customer_portal: missing결제는 됐지만 앱 권한은 바뀌지 않았습니다.
6단계: Checkout과 권한 반영을 분리해서 확인했습니다
문제를 한꺼번에 보지 않고 다음 네 구간으로 나눴습니다.
1. Checkout에서 주문·구독이 생성됐는가?
2. Lemon Squeezy가 웹훅을 보냈는가?
3. 앱이 서명을 검증했는가?
4. 이벤트가 로컬 사용자와 매핑돼 Pro로 바뀌었는가?1번은 성공했습니다. 2번도 Lemon Squeezy의 Recent deliveries에서 확인할 수 있었습니다.
문제는 3번이었습니다.
subscription_created → 400
subscription_updated → 400
subscription_payment_success → 400
{"error":"INVALID_WEBHOOK_SIGNATURE"}처음에는 대시보드와 .env에 입력한 Signing secret가 다르다고 판단했습니다. 로컬 secret의 존재 여부, 길이, 앞뒤 공백을 값 자체를 출력하지 않고 확인했습니다. 대시보드 값을 다시 복사해 로컬 설정과 맞춘 뒤 서버도 재시작했습니다.
하지만 실제 웹훅을 재전송해도 여전히 400이었습니다.
7단계: secret가 아니라 실행 중인 서버를 의심했습니다
여기서 같은 secret를 사용해 로컬에서 서명된 진단 요청을 만들었습니다. 이 요청은 외부 제공자를 거치지 않으므로, 현재 서버가 .env의 secret를 읽고 있다면 반드시 200이어야 합니다.
결과는 400이었습니다.
현재 .env secret로 생성한 로컬 signed probe
→ 400 INVALID_WEBHOOK_SIGNATURE이 결과로 문제 범위가 줄었습니다.
Lemon Squeezy가 서명을 이상하게 만든 문제가 아님
Cloudflare가 JSON을 바꾼 문제도 아님
대시보드 이벤트 종류 문제도 아님
실행 중인 서버가 현재
.env를 읽지 않고 있을 가능성이 큼
4173 포트를 확인하자 이전 설정으로 시작된 Node 서버가 계속 살아 있었습니다. 서버 실행 명령을 다시 내렸지만 새 프로세스가 현재 요청을 처리하는 것이 아니었습니다.
이전 서버만 종료하고 최신 .env로 다시 실행했습니다. 그리고 같은 로컬 signed probe를 보냈습니다.
서버 재시작 전 → 400 INVALID_WEBHOOK_SIGNATURE
잔류 서버 종료 후 → 200 { received: true, ignored: true }진단용 이벤트는 사용자 정보를 일부러 넣지 않아 권한은 바꾸지 않고 ignored로 끝났습니다. 하지만 Tunnel, raw body, secret, HMAC 검증, 이벤트 라우팅이 모두 통과한다는 것은 확인할 수 있었습니다.
8단계: 실제 웹훅을 다시 보내자 Free가 Pro로 바뀌었습니다
마지막으로 Lemon Squeezy 대시보드에서 실제 subscription_created 이벤트를 재전송했습니다.
이번에는 앱 DB가 다음처럼 바뀌었습니다.
plan: pro
subscription_status: active
customer_id: set
subscription_id: set
customer_portal: set브라우저 계정 화면에서도 다음을 확인했습니다.
Pro · ₩9,900/month
3 searches · unlimited
Manage billingCheckout 성공 화면뿐 아니라 실제 제공자가 보낸 서명된 이벤트, 서버 저장 상태, 브라우저 권한 표시까지 확인한 뒤에야 테스트 결제 흐름을 완료로 판단했습니다.
결과: 기술 데모의 결제 버튼이 실제 권한 흐름으로 이어졌습니다
이전 상태 | 현재 상태 |
|---|---|
이메일 가입·로그인 | 이메일 로그인 + Google 로그인 구조 |
Stripe 코드와 미설정 Checkout | Lemon Squeezy Hosted Checkout 테스트 완료 |
월 $7.99 표시 | 월 ₩9,900 표시 |
결제 제공자 국가 조건 미확인 | 한국 판매자 지원을 확인한 MoR 구조 선택 |
로컬 웹훅 수신 불가 | Cloudflare Tunnel로 실제 제공자 이벤트 수신 |
Checkout 성공 여부만 확인 | 서명 검증·사용자 매핑·Pro 권한까지 확인 |
Free 계정 | 실제 테스트 웹훅으로 Pro·무제한 전환 |
자동 테스트 22개 | 자동 테스트 30/30 통과 |
전체 자동 테스트는 다음 범위를 포함합니다.
이메일 가입·중복·비밀번호·로그인·로그아웃
HttpOnly 세션
Google 계정 생성·재사용·기존 이메일 연결
이미지 파일 검증과 사용량 처리
인증된 Checkout 사용자 정보 연결
서명된 구독 웹훅 처리
구독 생성 시 Pro 전환
구독 만료 시 Free 복귀
고객 포털 URL 반환
잘못된 서명을 400으로 거절하는 동작은 실제 Lemon Squeezy 전달 기록과 로컬 진단 요청으로 별도 확인했습니다.
결제 시스템을 바꾸면서 배운 점
1. 개발하기 편한 결제사와 내가 가입할 수 있는 결제사는 다릅니다
문서와 예제가 많은 결제사를 먼저 선택했지만 판매자 국가 지원을 뒤늦게 확인했습니다. 다음부터는 코드를 쓰기 전에 판매자 국가, 업종, 정산 수단, 신원 확인 조건부터 확인해야 합니다.
2. Checkout 성공은 권한 부여 성공이 아닙니다
결제 성공 페이지는 사용자 경험의 한 단계일 뿐입니다. 구독형 서비스에서는 제공자 이벤트가 서버에 도착하고, 서명이 검증되고, 올바른 사용자에게 매핑되고, 권한이 바뀌어야 완료입니다.
3. 설정값을 반복해서 바꾸기 전에 실행 중인 프로세스를 확인해야 합니다
이번 문제는 secret 오타처럼 보였습니다. 하지만 같은 secret로 만든 로컬 요청도 실패한다는 사실이 실행 중인 서버 문제를 드러냈습니다. 외부 시스템을 의심하기 전에 현재 포트를 누가 점유하고 있는지 확인하는 단계가 필요했습니다.
4. 오류는 단계별로 잘라야 빨리 찾을 수 있습니다
결제가 안 된다는 한 문장으로 보면 범위가 너무 큽니다. Checkout, 웹훅 전달, 서명, 사용자 매핑, 권한 변경을 나누자 어디까지 성공했고 어디부터 실패했는지 보였습니다.
5. AI가 맡을 일과 사람이 승인할 일을 나눴습니다
AI는 코드 수정, 테스트, 대시보드의 비민감 설정, 로그 분석, 브라우저 검증을 도왔습니다. 하지만 다음은 사람이 직접 했습니다.
Google 계정 선택
비밀번호 입력
Signing secret 입력과 보관
테스트 카드 입력
신원·사업·정산 정보
실제 결제 활성화 결정
빠르게 자동화하더라도 계정과 결제의 최종 권한까지 AI에 넘기지는 않았습니다.
같은 문제를 겪는다면 이 순서로 확인해보세요
[Checkout]
□ 테스트 모드와 가격·결제 주기가 맞는가
□ 주문과 구독이 제공자 대시보드에 생성됐는가
[Delivery]
□ 웹훅 URL이 외부 HTTPS에서 접근 가능한가
□ 제공자의 Recent deliveries에 이벤트가 있는가
□ 응답 코드와 본문은 무엇인가
[Signature]
□ raw JSON body를 파싱 전에 검증하는가
□ 헤더 이름과 HMAC 알고리즘이 맞는가
□ 대시보드와 실행 중인 서버의 secret가 같은가
□ 설정 변경 후 실제 서버 프로세스를 다시 시작했는가
[Entitlement]
□ Checkout에 로컬 사용자 식별자를 넣었는가
□ 웹훅에서 같은 사용자를 찾았는가
□ customer·subscription ID가 저장됐는가
□ 서버 DB와 브라우저 UI 모두 Pro로 바뀌었는가아직 완료되지 않은 것
이번에 완료한 것은 Lemon Squeezy 테스트 모드의 구독 결제 E2E입니다. 실제 해외 매출을 받은 것은 아닙니다.
남은 단계는 다음과 같습니다.
Google 계정 선택부터 세션 생성까지 실제 브라우저 최종 재검증
Lemon Squeezy 판매자 설문과 신원 확인 제출
스토어 활성화 심사
테스트 상품을 Live Mode로 복사
정산 계좌 또는 PayPal 연결
임시 Tunnel 대신 안정적인 공개 배포 URL에 웹훅 연결
환불·취소 정책, 개인정보처리방침, 이용약관 정리
해외 K-드라마 팬 5~10명에게 실제 사용 흐름 테스트
Lemon Squeezy의 스토어 활성화 안내와 시작 가이드는 심사 기간을 각각 2~3영업일, 1~2영업일로 안내합니다. 실제 기간은 신원 확인이나 위험 검토가 추가되면 더 길어질 수 있습니다.
고객 포털 URL도 앱에 연결됐지만 현재 스토어가 미활성화 상태라 포털 페이지는 접근이 차단됩니다. 이것도 오류를 숨기지 않고 출시 전 과제로 남겼습니다.
마무리
이번 작업 전에는 해외 결제를 붙인다는 말을 결제 버튼과 Checkout 페이지를 만드는 일로 생각했습니다.
실제로 해보니 결제는 하나의 버튼이 아니라 다음 연결이었습니다.
사용자 계정
→ Hosted Checkout
→ 주문과 구독
→ 서명된 웹훅
→ 로컬 사용자 매핑
→ Pro 권한
→ 구독 관리와 만료가장 오래 걸린 부분도 결제 화면을 만드는 일이 아니었습니다. 이미 성공한 것처럼 보이는 화면 뒤에서 실제 상태가 연결되지 않은 이유를 찾는 일이었습니다.
이번 시행착오를 통해 배운 것은 단순합니다.
서비스에서 중요한 것은 성공 화면을 만드는 것이 아니라, 성공한 사실이 실제 권한과 데이터로 이어지는지 끝까지 확인하는 것입니다.





Stripe가 한국 사업자 조건에서는 국가 선택 단계에서 막힌다는 건 저도 이 글 보고 처음 알았습니다. 지원되지 않는 국가를 임의로 고르지 않고 MoR 구조로 갈아타신 판단도, 뒤에 올 사업자 확인과 정산을 생각하면 결국 가장 빠른 길이었을 것 같습니다.
secret를 몇 번을 다시 맞췄는데도 400이 계속 나오던 구간은 크게 공감이 되네요ㅠ 같은 secret로 로컬에서 서명한 진단 요청을 만들어 '외부를 거치지 않으니 200이어야 한다'로 범위를 좁히신 방법이 정말 좋았습니다.
여기서 조금 더 나아가시면, 헬스체크 응답에 지금 떠 있는 프로세스의 시작 시각과 로드한 secret의 해시 앞 몇 자리를 실어두시는 걸 권하고 싶습니다. 예를 들어, .env를 고친 뒤 /api/health를 한 번 불러서 해시가 그대로면 그것만으로 잔류 서버가 처리하고 있다는 게 바로 보이거든요.
프로세스를 치우실 때는 이름 패턴으로 몰아 죽이지 않고 포트를 점유한 것만 찾아 종료하시는 쪽이 안전합니다.
사례 공유 감사드립니다:)
오 그렇군요!!! 너무 감사합니다 ㅠㅠ!!