SaaS 결제 연동, 혼자서 가능할까?

Pipedeck 실제 화면

작성자

카테고리:

혼자 만든 서비스에 결제를 붙이는 날, 진짜 막히는 건 코드가 아니다

1인 SaaS 결제 연동 하는 방법을 검색하는 순간이면 대개 이런 상태다. 서비스는 어느 정도 돌아가는데, 돈을 받을 길이 없다. 사업자가 있어야 하나, PG 계약은 개인도 되나, 웹훅은 뭘 저장해야 하는지. 튜토리얼은 결제창 띄우는 데 10분 걸린다고 하는데 현실은 그렇지 않다.

나도 처음엔 코드 문제인 줄 알았다. 튜토리얼대로 클라이언트 키 넣고 결제창까지는 금방 띄웠다. 진짜 시간을 먹은 건 그 뒤였다. 사업자 조건, 정산 주기, 웹훅이 도착하지 않았을 때 서비스 권한을 어떻게 열어줄지. 결제 성공 화면과 실제 권한 부여 사이에 있는 틈이 문제였다.

튜토리얼은 10분인데 왜 나는 2주가 걸렸나

결제창 띄우기는 문서가 친절하다. 막히는 건 문서가 안 다루는 영역이다. 결제 성공 뒤에 내 서비스가 알아서 권한을 열어줘야 하고, 결제가 실패하거나 카드가 만료되면 알아서 닫아줘야 한다. 이 흐름을 설계하는 데 코드 붙이는 시간보다 훨씬 오래 걸렸다.

결제 연동, 실제로는 무엇부터 해야 하나

순서는 이렇다. 사업자 조건 확인, PG 선택, 클라이언트 키 연동, 웹훅 처리, 테스트 결제, 실전 전환, 그리고 운영. 이 글은 이 순서대로, 각 단계에서 어디서 망하는지를 적는다. 코드 샘플보다 실패 지점이 더 아프게 배우는 자리다.

PG 없이도 되나? 사업자등록 조건부터 개인 가능 여부까지

개인(비사업자)으로 결제 붙이는 방법과 그 함정

비사업자도 쓸 수 있는 수단은 있다. PG 몇 곳은 개인 판매자 계약을 열어두고, 그 외에는 후원 링크 형태 서비스가 있다. 다만 세금계산서 발행이 안 되고, 환불 분쟁 대응이나 정기결제 지원이 제한적인 경우가 많다. 검증 몇 번 해보고 상용 서비스에 붙이긴 부담스러웠다.

개인사업자 등록, 언제 하면 손해 없는지

내 경우엔 서비스를 만들다가 실제로 돈을 받을 시점이 보였을 때 등록했다. 등록 자체는 어렵지 않은데, 타이밍을 고민했다. 너무 일찍 하면 유지 신경 쓸 게 늘고, 너무 늦으면 첫 매출을 놓친다. 유료 전환을 결심한 날과 사업자 신청 날을 붙이는 게 관리하기 편했다. 춘천에서 스튜디오 형태로 굴리다 보니 등록 주소와 실제 작업 공간 정리도 같이 했다.

간이과세 vs 일반과세, SaaS에는 무엇이 맞나

간이과세는 부가세율이 낮지만 세금계산서 발행이 안 된다. B2B 납품이 아니라 일반 유저 대상 구독 SaaS라면 간이과세로 시작해도 크게 막히는 건 없었다. 다만 사업자 고객이 들어오는 순간 세금계산서 요청이 오고, 그때 일반과세 전환을 검토하게 된다. 처음부터 B2B가 타깃이라면 일반과세로 시작하는 게 나중에 덜 헷갈린다.

토스페이먼츠말고 뭘 쓸까: PG 선택과 수수료 실제 계산

PG·간편결제·구독관리 서비스, 무엇이 다른가

섞어 쓰는 경우가 많은데 나눠서 보자. PG는 카드사와 내 서비스 사이에서 결제를 대행한다. 간편결제는 그 위에 얹힌 사용자 경험층이고, 구독관리 서비스는 정기결제 빌링 로직과 고객 관리까지 대신 해준다. 1인 입장에서 정기결제를 직접 만들지, 빌링 서비스에 맡길지가 첫 갈림길이다.

선택지 수수료 정기결제 1인에게 맞는 순간
토스페이먼츠 등 국내 PG 직접 연동 건당 카드 수수료, 부가세 별도 정기결제 API 별도 신청 거래 수가 어느 정도 있고 로직을 직접 굴리고 싶을 때
스토리보트 같은 구독 관리 서비스 월 요금 + PG 수수료 기본 제공 빌링 로직 만들 시간이 없을 때
글로벌 결제 서비스 건당 비율 + 고정 요금 기본 제공 해외 카드 결제가 필요할 때

수수료·정산·부가세까지 포함한 진짜 비용 계산법

건당 수수료만 보면 계산이 틀린다. 부가세가 별도로 붙고, 정산은 결제일로부터 며칠씩 뒤에 들어온다. 내가 실제로 정산 내역을 열어 확인했을 때, 눈에 보이는 매출과 통장에 들어온 금액 사이에 수수료와 부가세 차감이 그대로 찍혀 있었다. 월 단위로 정산액을 모아 보면 매출이 조금씩 깎여 보이는 게 정상이라는 걸 알게 됐다. 매출이 낮을 때는 건당 수수료 차이보다 월 최소 요금이 더 아프다. 거래가 늘어나면 그때 조건 재협상이나 갈아타기를 검토하면 된다. 갈아타기 판단 기준은 하나다. 월 고정 비용이 수수료 절감액보다 커지는 순간이다.

Pipedeck 실제 화면

웹훅 없이 결제 붙이면 반드시 생기는 일

웹훅이란 결제가 일어났을 때 PG가 내 서버로 보내주는 자동 알림이다. 클라이언트의 성공 콜백은 브라우저가 닫히면 사라지지만, 웹훅은 서버 대 서버로 도착하기 때문에 결제와 권한 부여를 이어 주는 신뢰할 만한 연결고리가 된다.

웹훅은 왜 필수인가: 결제 성공과 서비스 접근 권한의 시차

사용자가 결제창에서 성공하고, 내 서버가 그 사실을 알고, 권한을 열어준다. 이 사이에 시차가 있다. 성공 페이지 리다이렉트만 믿고 권한을 열면, 결제 없이 URL을 직접 두드려 들어오는 경우를 막을 수 없다. 웹훅이 도착했을 때 비로소 진짜 돈이 들어온 걸로 처리하는 게 정석이다.

웹훅이 실패하면 벌어지는 일

웹훅은 늦게 오기도 하고, 같은 결제에 대해 여러 번 오기도 한다. 재시도 정책이 있는 PG는 실패하면 다시 보낸다. 그래서 같은 결제 이벤트가 두 번 저장되는 실수가 생긴다. 반대로 서버가 잠깐 죽어 있으면 웹훅을 아예 못 받고, 돈은 났는데 유료 기능에 접근 못 하는 유저가 생긴다. 결제 성공과 권한 상태가 어긋나는 이 불일치가 1인 운영에서 제일 무서운 사고다.

멱등성과 재시도, 1인이 만들 수 있는 최소 안전장치

내가 지키는 규칙은 단순하다. 웹훅 payload의 결제 고유 키를 저장하고, 이미 있는 키면 아무것도 하지 않고 200만 돌려준다. 이게 멱등성이다. 그리고 하루 한 번 결제 내역과 권한 상태를 대조하는 배치를 cron으로 돌린다. 지금 무인 cron이 63개 도는 중인데, 결제 감시 배치도 그중 하나다. 웹훅을 놓쳐도 다음 날 배치가 잡아주니 새벽에 사고 알림을 받는 일이 줄었다.

Pipedeck 실제 화면

테스트 결제부터 실전 배포까지, 놓치면 크는 체크 포인트

테스트 키로 흘려보는 정상·실패·취소 시나리오

정상 결제만 테스트하면 안 된다. 실패 카드로 거절 흐름, 결제 직후 취소, 그리고 같은 웹훅을 두 번 쏴서 중복 처리가 되는지까지 흘려봐야 한다. 테스트 키는 실제로 돈이 안 빠지니 마음껏 부숴도 된다.

배포 전 최종 점검표

  • 테스트 키와 실전 키가 환경변수로 분리되어 있는지, 코드에 키가 박혀 있지 않은지
  • 웹훅 수신 URL이 실전 도메인으로 등록됐는지
  • 같은 웹훅을 두 번 보냈을 때 권한이 두 번 열리지 않는지(멱등성)
  • 결제 실패 시 사용자에게 보여줄 안내 화면이 있는지
  • 환불 시 권한이 닫히는지
  • 실결제 1건을 직접 해보고 정산 대기 상태까지 확인했는지

실전 키 교체할 때 흔한 실수는 클라이언트 키만 바꾸고 시크릿 키를 놓치는 거다. 그러면 결제창은 뜨는데 서버 검증이 엉뚱한 키로 돌아간다. 배포 직후엔 내 카드로 실결제를 하고, 영수증, 웹훅 로그, 권한 상태 세 가지가 일치하는지 봤다. 그다음 바로 환불했다. 이 습관은 지금도 유지 중이다.

Pipedeck 실제 화면

해지·환불·정기결제 실패, 자동으로 굴러가게 만드는 법

해지 요청 처리: 즉시 차단 vs 기간 말료

내가 택한 건 기간 말료다. 이미 낸 돈의 기간까지는 쓰게 하고, 해지 요청 시점에 만료일만 바꾼다. 즉시 차단은 환불 요청을 불러온다. 다만 악용이 우려되면 즉시 차단 정책을 명시하고 가입 시 보여주면 된다.

환불 처리와 권한 회수 흐름

환불은 PG 콘솔에서 실행하고, 그 결과가 웹훅으로 돌아오면 권한을 닫는 흐름으로 만들었다. 콘솔에서 환불하고 끝내면 내 서비스에는 유료 권한이 그대로 남는다. 환불 이벤트 웹훅을 권한 회수 트리거로 연결해두니 손으로 정리할 게 없어졌다.

카드 만료·결제 실패 재시도(더닝) 정책 설계

정기결제가 실패하는 대부분의 이유는 카드 만료, 한도, 잔액이다. 실패했다고 바로 해지하면 아까운 유저가 나간다. 재시도 간격을 두고, 실패 시 사용자에게 카드 업데이트 안내 메시지를 보낸다. 안내 타이밍은 결제 실패 직후와 재시도 하루 전에 나눠 보내는 편이고, 문구는 “결제가 실패해서 서비스가 곧 멈춰요”보다 “카드만 바꿔주시면 그대로 이어서 쓸 수 있어요”가 응답률이 낫다는 걸 메일 답장으로 확인했다. 결제 상태와 권한 상태의 불일치는 매일 배치가 잡아준다. 사람이 매일 들여다보는 건 오래 못 간다. 나는 못 한다.

정리: 1인 SaaS 결제 연동, 이 순서로만 가면 망하지 않는다

사업자 조건 확인 → PG 선택(수수료는 월 정산으로 계산) → 클라이언트 키 연동 → 웹훅 멱등 처리 → 정상·실패·취소 테스트 → 실결제 확인 → 해지·환불·더닝 자동화. 이 순서를 벗어나면 어딘가에서 웹훅을 놓치거나 환불 후 권한이 남는 사고가 터진다.

오늘 할 일은 하나면 충분하다. PG 개발자 콘솔에 가입하고 테스트 키로 결제창 하나 띄워보는 것. 그다음 단계는 이 글을 다시 열면 된다.

나는 잘된 것도 망한 것도 그대로 적는 걸 원칙으로 한다. 결제 연동도 마찬가지로, 막힔 때마다 그 자리를 기록해뒀기 때문에 이 글이 나올 수 있었다. 직접 만들어 굴리는 서비스들은 wallenstein.dev에 모아뒀다. 결제 붙이다 막히는 지점이 있으면 댓글로 남겨달라. 아는 선에서 순서를 같이 짜보겠다.

출처와 근거 자료


글쓴이 정보

춘천에서 AI 자동화로 서비스를 만들어 운영합니다. 릴스·쇼츠는 직접 만든 ClipSquare 로 만듭니다.

궁금해할 만한 것들

1인 SaaS 결제 연동에는 사업자등록이 꼭 필요한가요?

필요는 없지만 거의 필수라고 보는 게 맞습니다. 개인 판매자 계약이 가능한 PG나 후원 링크 서비스가 있긴 한데, 세금계산서 발행이 안 되고 정기결제·환불 대응이 제한적인 경우가 많습니다. 유료 전환을 결심한 시점에 개인사업자 등록을 함께 진행하는 게 관리하기 편합니다.

결제 연동에서 웹훅은 왜 필수인가요?

브라우저의 성공 콜백은 창이 닫히면 사라지지만, 웹훅은 PG가 서버로 직접 보내주는 알림이라 신뢰할 수 있는 유일한 연결고리이기 때문입니다. 성공 페이지 리다이렉트만 믿고 권한을 열면 URL을 직접 두드려 무료로 들어오는 경우를 막을 수 없습니다. 웹훅 도착을 기준으로 권한을 여는 게 정석입니다.

1인 SaaS는 간이과세와 일반과세 중 무엇으로 시작해야 하나요?

일반 유저 대상 구독 SaaS라면 간이과세로 시작해도 크게 막히지 않습니다. 다만 B2B 고객이 들어와 세금계산서 요청이 오는 순간 일반과세 전환을 검토하게 됩니다. 처음부터 B2B가 타깃이라면 일반과세로 시작하는 게 나중에 덜 헷갈립니다.