결제 연동, 이 검증 없이 붙이면 돈이 새는 이유

결제 연동 검증 없이 돈 새는 모습

작성자

카테고리:

왜 결제 연동은 ‘붙이는 것’보다 ‘검증’이 문제인가

혼자 SaaS를 만들다가 결제 단계에 도착하면 대부분 멈칫한다. 코드는 잘 짜는데 돈이 걸려 있으니까. 나도 첫 결제 연동 때 위젯 띄우고 테스트 카드로 결제되는 걸 확인한 다음, “됐다” 하고 배포했다가 웹훅 처리가 빠져 있다는 걸 나중에 알았다. 다행히 유료 사용자가 없을 때라 망정이지, 이걸 사람 들어온 뒤에 발견했으면 잠을 못 잤을 거다.

기능은 되는데 돈이 새는 구조

PG 위젯 붙이고 카드 승인까지 뜨면 연동은 끝난 것처럼 보인다. 그런데 실제로 문제가 생기는 지점은 그 뒤다. 승인은 됐는데 내 서비스 DB에 기록이 안 남거나, 반대로 결제 없이 구독만 열리거나, 같은 결제가 두 번 처리되거나. 어느 쪽이든 사람이 실시간으로 지켜보지 않는 한 아무도 모른다.

1인 빌더가 결제 단계에서 무서워하는 것들

정리해 보면 결국 두 가지다. “내가 검증을 안 해서 사고가 나면 어쩌지”와 “사고가 났는데 내가 모르면 어쩌지”. 이 글은 연동 순서도 다루지만, 무게는 뒤쪽에 둔다. 출시 후에도 매일 무인으로 돈이 새는지 감시하고, 새면 복구하는 구조까지 정리했다. 코드 복붙 가이드는 PG 문서에 이미 있다.

1인 사업자는 어떤 PG부터 시작해야 하나

첫 PG 선택 기준: 수수료보다 중요한 것

수수료율은 1인 초기 트래픽에서는 별 차이가 안 난다. 월 결제 몇 건 안 되는 시기에 0.1퍼센트를 줄여봐야 금액이 없다. 내가 실제로 본 기준은 이렇다.

  • 문서와 개발자 콘솔이 읽히는가. 연동 대부분의 시간은 문서 읽는 시간이다.
  • 테스트 환경이 별도로 열려 있는가. 계약 전에 샌드박스를 못 써보면 리스크가 크다.
  • 문의 응답이 오는가. 1인은 물어볼 동료가 없어서 PG 문의창구가 유일한 지원선이다.
  • 정산 최소 금액 조건. 트래픽 0일 때 억지로 정산이 막히면 현금흐름이 꼬인다.

토스페이먼츠 문서가 연동 편의성 면에서 무난해서 시작하기 좋았다. 나중에 조건이 맞으면 다른 PG를 이중으로 붙이는 방법도 있는데, 초기에는 하나로 충분하다.

사업자 없이 테스트하는 방법과 한계

사업자등록 전에는 실 결제 승인을 받을 수 없다. 다만 대부분의 PG가 개발자용 테스트 키를 계약 없이 발급해 준다. 연동 개발 전체를 테스트 키로 끝내 놓고, 사업자등록이 나오면 라이브 키만 바꿔 끼우는 순서로 가면 된다. 한계는 정산, 환불 정책, 세금계산서 같은 ‘계약 조건’은 실제 계약 전엔 확인이 안 된다는 거다.

언제 갈아타는가: 초기 선택의 철학

첫 PG는 ‘갈아탈 수 있는 구조’로 붙인다. 결제 호출 지점을 한 곳에 모아 두고, 웹훅 처리 로직을 PG별로 분리해 두면 나중에 갈아탈 때 서비스 코드를 다 만지지 않아도 된다. 첫 선택에 목숨 걸지 말고, 갈아탈 비용을 낮춰 두는 쪽이 1인에게 맞는 철학이다.

결제 연동 세팅 순서: 어디서 테스트하고 어디서 멈추나

계약에서 실전 전환까지 6단계

  1. 계약 및 키 발급. 테스트 키와 라이브 키를 분리해 환경변수로만 관리한다. 코드에 하드코딩하면 나중에 지옥이다.
  2. 결제 위젯 연결. 클라이언트에서 PG 위젯을 띄운다. 여기까지는 문서 따라 하면 된다.
  3. 웹훅 수신 엔드포인트 구현. 승인, 취소, 환불, 구독 갱신 이벤트를 받아서 DB에 기록한다. 여기부터가 진짜 연동이다.
  4. 샌드박스 테스트. 아래 5가지 케이스를 전부 돌린다.
  5. 실전 키 전환. 키만 바꾸는 게 아니라 웹훅 URL이 라이브 도메인으로 등록돼 있는지도 확인한다.
  6. 소액 실결제. 내 카드로 실제로 결제하고 환불까지 해 본다. 진짜 돈이 움직이는 경로는 테스트 카드와 다르게 굴 때가 있다.

샌드박스에서 반드시 돌려봐야 할 5가지 케이스

  • 정상 승인: 결제 성공 후 플랜이 열리는가
  • 승인 실패: 한도 초과 카드, 오류가 났을 때 사용자에게 뭐가 보이는가
  • 중복 클릭: 결제 버튼을 연타했을 때 한 건만 처리되는가
  • 취소와 환불: 승인 직후 취소, 며칠 뒤 환불 두 경우 모두 플랜이 닫히는가
  • 웹훅 지연: 웹훅이 늦게 오거나 두 번 왔을 때 어떻게 되는가. 웹훅은 최소 두 번 온다고 가정하고 짜야 한다.

실전 전환 스위치를 켤 때 확인할 것

실전 전환 날에는 내가 정해 둔 루틴을 그대로 밟는다. 라이브 키 확인, 웹훅 URL 확인, 시그니처 검증 코드가 라이브에서도 켜져 있는지 확인, 그리고 소액 실결제 한 건. 이 네 가지를 확인하기 전엔 배포 공지를 보내지 않는다.

1인 사업자 PG 선택 장면

웹훅 검증 없이 배포하면 벌어지는 일

시나리오 1: 결제 안 하고 구독 열리는 사고

웹훅 시그니처 검증이란, “내 서버로 온 결제 성공 알림이 진짜 PG가 보낸 것인지”를 확인하는 절차다. 웹훅이란 PG 쪽에서 결제 사건이 생길 때마다 내 서버로 보내주는 자동 알림이다. 이 검증이 없으면 누군가 내 웹훅 URL로 결제 성공과 똑같은 생김새의 요청을 마음대로 보낼 수 있다. 스크립트 몇 줄이면 된다. 그러면 돈 한 푼 안 내고 유료 플랜이 열린다. 1인 SaaS는 이런 시도를 받아주는 열린 문 같은 구조라서, 검증 없이 배포하는 건 계산대에 무인 편의점 간판을 거는 것과 비슷하다.

시나리오 2: 승인됐는데 플랜이 안 열리는 사고

반대 방향 사고도 있다. 고객은 실제로 카드 결제가 됐는데, 웹훅 처리에서 에러가 나거나 요청이 드롭돼서 내 DB에는 기록이 안 남는다. 고객 입장에서는 돈 나갔는데 서비스가 잠겨 있는 상태다. 이건 새는 돈이 아니라 새는 신뢰인데, 둘 다 무인으로 감시하지 않으면 며칠씩 모른다.

시그니처 검증·멱등성 처리가 왜 최소선인가

검증 로직 자체는 어렵지 않다. PG 문서에 있는 시크릿 키로 요청 본문의 서명을 확인하는 형태다. 예를 들어 이런 식이다.

// 웹훅 시그니처 확인 의사코드 (실제 구현은 각 PG 문서 기준)
const expected = hmacSHA256(secretKey, rawBody);
if (expected !== requestHeader["signature"]) {
  return res.status(400).end(); // 위조 요청은 여기서 버림
}
// 멱등성: 같은 결제 ID가 이미 처리됐으면 스킵
if (await db.exists(paymentId)) return res.status(200).end();
await db.save(paymentId, payload);

멱등성이란 같은 요청이 두 번 와도 결과가 한 번만 적용되게 하는 설계다. 웹훅은 PG가 재발송하기도 해서, 이게 없으면 같은 결제로 크레딧이 두 번 쌓인다. 돈이 새는 지점을 지도로 그려보면 이렇다: 위조 요청 통과, 웹훅 드롭, 중복 처리, 환불 미반영, 그리고 대사 안 한 정산 오차. 다섯 곳 전부 무인 감시 대상이다.

결제 연동 테스트 세팅 순서

결제 승인 누락: 어떻게 알고 어떻게 복구하나

무인 크론으로 매일 대조하는 구조

나는 매일 정해진 시간에 도는 크론으로 PG 거래내역과 내 서비스 DB를 대조한다. PG 쪽엔 승인 내역이 있는데 내 DB에 없으면 웹훅 드랍, 반대면 이상 징후. 임계값은 단순하게 잡았다. ‘당일 승인 건 중 내 DB에 없는 게 하루가 지나도 있으면’ 알림을 보낸다. 하루를 주는 이유는 PG 쪽 집계 지연 때문에 새벽 대사에서 오탐이 나오는 걸 한 번 겪어서다. 크론은 지금 서버에 70개가 돌고 있는데, 결제 대사 크론이 그중 하나다.

누락 발견 시 복구 플레이북

  1. 알림 확인: 어떤 결제 ID가 빠졌는지, 금액과 시각을 확인한다.
  2. PG 콘솔 대조: 실제 승인 내역과 맞는지 눈으로 본다.
  3. 수동 복구: 결제 API로 해당 건을 다시 조회해서 그 결과로 DB에 기록한다. 웹훅이 아닌 조회 API로 복구하는 게 포인트다.
  4. 원인 기록: 같은 원인이 반복되면 웹훅 수신 로직을 고친다.

고객에게 알림 때와 말지 않을 때

누락을 발견하고 복구했으면 고객에게는 짧게라도 알린다. “결제는 정상 처리됐는데 시스템 반영이 늦었습니다. 현재 열려 있습니다.” 말하지 않고 넘어가면 고객은 그 몇 시간 동안 ‘돈만 뺏긴 서비스’를 경험한 상태라서, 나중에라도 알게 되면 신뢰가 갈린다. 반대로 원인 파악 전에 장황한 기술 설명을 붙이지는 않는다.

웹훅 누락 결제 복구와 정산 자동화

정산·수수료 확인과 월말 자동화

정산 주기·수수료·최소 정산액 확인법

계약서와 PG 콘솔에 정산 주기, 수수료, 최소 정산액이 나온다. 1인이 실제로 걸리는 건 최소 정산액이다. 초기에 결제가 몇 건 안 되면 정산이 안 되고 다음 달로 넘어가는데, 이걸 모르고 ‘왜 입금이 안 되지’ 하고 있을 수 있다. 계약할 때 이 조건부터 읽어두자.

매달 대사를 무인으로 돌리는 방법

나는 정산 예상액과 실수령액을 매달 대사한다. 방식은 단순하다. 내 DB의 월 결제 합계에서 PG 콘솔의 정산 예정액을 빼고, 수수료를 감안한 오차가 임계치를 넘으면 알림이 오게 해 뒀다. 스프레드시트에 기록을 쌓는데, 어느 달엔 예상보다 실수령액이 낮아서 원인을 뒤져보니 환불 건 집계 시점이 어긋나 있었다. 이런 건 기록이 쌓여야 잡힌다.

세금계산서와 부가세, 1인이 놓치는 것

매출이 올라가면 부가세 신고 때 PG 수수료 매입세액공제를 챙겨야 하는데, 이걸 놓치는 1인이 많다. PG가 내주는 수수료 세금계산서를 매 분기마다 받아서 보관하는 습관을 자동화 폴더에 넣어뒀다. 세무사를 붙이든 직접 하든, 이 서류가 없으면 그만큼 세금을 그냥 내는 거다.

정리: 출시 전에 딱 한 번 훑는 15개 체크포인트

결제 검증 체크리스트 15 (복사용)

  1. 테스트 키와 라이브 키가 환경변수로 분리돼 있다
  2. 웹훅 시그니처 검증이 라이브에서도 켜져 있다
  3. 웹훅 중복 수신을 가정한 멱등 처리가 있다
  4. 승인 실패 시 사용자에게 안내 문구가 뜬다
  5. 중복 클릭을 테스트했다
  6. 취소와 환불 모두 플랜이 닫히는지 확인했다
  7. 웹훅 수신 실패 시 재발송 로직이나 대사 크론이 있다
  8. 소액 실결제로 전 과정을 돌려봤다
  9. 내 카드로 환불까지 실제로 해봤다
  10. 정산 주기와 최소 정산액을 알고 있다
  11. 수수료율과 환불 수수료 조건을 기록해 뒀다
  12. 일일 대사 크론이 돌고 알림이 온다
  13. 누락 복구 플레이북을 문서로 갖고 있다
  14. 환불 정책 문구가 서비스에 공개돼 있다
  15. PG 수수료 세금계산서를 받아 보관하는 흐름이 있다

이 리스트는 내 운영 문서에서 그대로 옮긴 거라서, 복사해서 쓰셔도 된다.

지금 결제를 붙여야 하나, 미뤄야 하나

무료 이용자가 아직 없다면 결제보다 먼저 할 게 있다. 다만 결제를 미룬다고 검증 구조까지 미루면 나중에 한꺼번에 터진다. 웹훅 수신과 대사 크론 구조는 미리 깔아 두고 스위치만 꺼두는 편이 마음이 편했다.

다음 글로 이어갈 것

결제가 붙으면 다음 관문은 유료 사용자의 이탈과 환불 요청 처리다. 그리고 이 블로그의 자동 파이프라인이 어떻게 이런 운영 문서를 매일 만들어 내는지도 [https://wallenstein.dev 포트폴리오]에 정리를 계속하고 있다. 결제 연동하다 막히는 지점이 있으면 댓글로 남겨주면 다음 글 소재로 쓰겠다.

참고한 공식 문서


글쓴이 정보

아일리고입니다. 자동화를 만들고 굴리며 겪은 일을 여기에 적습니다. 숏폼 영상은 ClipSquare 를 씁니다.