← 에디토리얼

바이브코딩 따라 하기 · 2026.11.12 · 7분

토스 결제창 바이브코딩으로 붙여 보니

AItoZ 개발팀 · 2026.11.12 발행

토스 결제창 바이브코딩으로 붙여 보니 — 바이브코딩 따라 하기

클로드 코드(바이브코딩)로 만든 한 장짜리 상품 페이지에 토스페이먼츠 결제위젯을 테스트 키로 붙여 봤습니다. 한 마디에 결제 완료까지 갔지만, 막힌 곳은 결제 다음이었습니다. 보낸 말 두 줄과 걸린 시간, 실제 돈을 받기 전에 해야 할 일을 정리했습니다.

2026년 11월 12일 직접 시험 · 클로드 코드 2.1.322(Opus 5.5) · 토스페이먼츠 결제위젯 SDK v2 · 문서용 공개 테스트 키 · 걸린 시간은 1회 측정값 · 화면 속 결제는 모두 테스트(실제 결제 아님)

클로드 코드에 한 마디 했더니 우리 상품 페이지에 결제창이 떴다

바이브코딩으로 사이트를 하나 만들고 나면 "여기서 돈도 받아 볼 수 있을까?"가 궁금해집니다. 그래서 '주말 플래너 PDF · 3,900원'이라는 가상의 상품 한 개만 있는 한 장짜리 페이지를 새로 만들고, 클로드 코드에 토스페이먼츠 결제위젯을 붙여 달라고 해 봤습니다. 결론부터 말하면 결제창까지는 정말 금방이었고, 막힌 곳은 결제가 끝난 다음이었습니다.

클로드 코드에는 뭐라고 보냈나요?

첫 번째로 보낸 말은 이 한 줄입니다. 상품 페이지 폴더(index.html과 상품 사진 한 장)에서 클로드 코드를 열고 그대로 보냈습니다.

이 상품 페이지에 토스페이먼츠 결제위젯 붙여 줘. 테스트 키로.

3분 38초(218초) 뒤 작업이 끝났습니다. index.html에 결제위젯(결제수단 · 약관 화면)이 들어갔고, server.js · success.html · fail.html 세 파일이 새로 생겼습니다. 키는 토스페이먼츠 문서에 공개된 테스트 키를 썼고, 실행 방법(node server.js 뒤 http://localhost:3000 열기)까지 알려 줬습니다.

구매하기를 누르면 펼쳐지는 결제위젯 — 위에 '테스트 환경이에요. 실제로 결제되지 않아요.' 표시

결제위젯 위에는 "테스트 환경이에요. 실제로 결제되지 않아요."라는 표시가 계속 붙어 있습니다. 결제하기를 누르면 결제창이 페이지 위에 뜨고, 테스트 환경에서는 휴대폰 번호와 비밀번호(000000)가 미리 안내돼서 끝까지 눌러 볼 수 있었습니다. 퀵계좌이체 테스트 화면으로 진행했더니 '결제를 완료했어요' 화면까지 한 번에 갔습니다.

서버를 만들라고 안 했는데 왜 서버가 생겼나요?

결제 승인을 서버에서 해야 하기 때문입니다. 토스페이먼츠 연동 가이드의 순서는 ① 결제위젯 그리기 ② 결제 요청 ③ 성공 주소로 이동 ④ 결제 승인 API 호출(서버) ⑤ 승인 결과 확인입니다. 승인 API는 시크릿 키로 인증해서 부르는데, 가이드에는 "시크릿 키는 클라이언트, GitHub 등 외부에 노출되면 안 됩니다"라고 적혀 있습니다. 브라우저에 시크릿 키를 둘 수 없으니 서버가 필요한 것이죠.

결제 승인은 서버에서 — 결제창(브라우저) → 결제 요청 → 승인 API(서버 · 시크릿 키)

클로드가 만든 server.js는 패키지 설치 없이 도는 Node 서버였고, 세 가지를 하고 있었습니다.

  1. 상품 가격을 서버가 정하고, 결제 전에 주문(주문번호 · 금액)을 만들어 둔다.
  2. 결제 뒤 돌아오면 금액이 그 주문과 같은지 확인한다(브라우저에서 금액을 바꿔 결제하는 것을 막기 위해).
  3. 시크릿 키로 결제 승인 API를 부른다. 실제 키는 코드에 넣지 말고 환경 변수 TOSS_SECRET_KEY로 넘기라고 안내했다.

가이드에는 승인을 부르지 않으면 "아직 결제 요청 중"이라 결제가 완료되지 않는다는 설명과, 결제 요청 뒤 10분 안에 승인해야 한다는 주의도 있습니다. 결제창만 띄우고 승인 단계를 빼먹으면 돈이 안 들어오는 이유가 여기 있습니다.

그럼 어디서 막혔나요?

결제가 끝난 다음이었습니다. '결제를 완료했어요' 화면에는 상품 · 금액 · 주문번호만 있고, 정작 산 PDF를 받을 곳이 없었습니다. 클로드도 작업 보고 끝에 "결제가 승인된 뒤 PDF 다운로드 권한을 주는 부분은 아직 없습니다"라고 적어 두긴 했는데, 보고를 꼼꼼히 읽지 않으면 놓치기 쉬운 한 줄이었습니다.

첫 번째 지시 결과 — 결제는 완료됐는데 산 PDF를 받을 곳이 없다

디지털 상품을 파는 페이지라면 결제창보다 이 부분이 더 중요합니다. 손님 입장에서는 돈을 냈는데 받을 게 없는 상황이니까요.

한 마디 더 하면 해결되나요?

네, 같은 대화에 이어서 이렇게 보냈습니다.

결제 완료 화면은 뜨는데, 산 PDF를 받을 곳이 없어. 결제가 승인되면 바로 PDF 내려받기 되게 해 줘.

2분 57초(177초) 뒤 결제 완료 화면에 'PDF 내려받기' 칸이 생겼습니다. 승인된 주문에만 그 주문 전용 내려받기 링크가 만들어지고, 링크는 24시간 동안 쓸 수 있습니다. 결제 없이 파일 주소로 바로 들어가거나 틀린 링크를 쓰면 막히게(404) 해 뒀고, 완료 화면에 들어오면 A4 파일이 바로 내려받아지기 시작합니다. 판매할 PDF 원본이 없어서 'SAMPLE'이라고만 적힌 임시 파일 두 개(A4 · A5)를 files/ 폴더에 넣어 뒀으니, 실제 파일로 덮어쓰라는 안내도 있었습니다.

두 번째 지시 결과 — 승인된 주문에만 24시간짜리 내려받기 링크

같은 테스트 결제를 처음부터 다시 해 보니 완료 화면에서 A4 파일 내려받기가 실제로 시작됐습니다.

순서 보낸 말 걸린 시간 결과
1 토스페이먼츠 결제위젯 붙여 줘. 테스트 키로. 3분 38초 결제위젯 · 승인 서버 · 완료/실패 화면, 테스트 결제 완료
2 승인되면 바로 PDF 내려받기 되게 해 줘 2분 57초 승인된 주문에만 24시간 내려받기 링크

claude -p 결과에 찍힌 사용량 환산값(total_cost_usd)은 1번 약 0.96달러, 2번 약 1.69달러였습니다. 구독 요금제인지 API 결제인지에 따라 실제 청구 방식은 다릅니다.

이대로 실제 돈을 받을 수 있나요?

아니요. 지금 것은 테스트라 돈이 빠져나가지 않습니다. 토스페이먼츠 가이드에는 "테스트 환경에서는 결제가 가상으로만 이뤄지기 때문에 결제수단에서 금액이 차감되지 않아요"라고 적혀 있습니다. 실제 결제를 받으려면 순서가 하나 더 있습니다.

  1. 전자결제 신청: 가이드에 따르면 결제 연동 키(실제 키)는 "토스페이먼츠 전자결제 신청 이후에만 확인할 수 있"습니다. 신청 전에는 테스트 키로만 연동해 볼 수 있습니다.
  2. 계약 · 심사: 토스페이먼츠 블로그(2026.11.01)는 "라이브 환경에서는 계약과 심사가 완료된 결제수단만 정상적으로 이용할 수" 있다고 안내합니다.
  3. 실제 키로 바꾸기: 클라이언트 키는 index.html에서, 시크릿 키는 코드가 아니라 환경 변수로 넘깁니다.
  4. 주문 저장소 바꾸기: 이번 코드는 주문 · 내려받기 링크를 메모리에만 저장해서 서버를 다시 켜면 사라집니다. 실제로 팔기 전에는 데이터베이스 저장이나 결제 뒤 링크를 메일로 보내는 기능이 필요합니다(클로드가 TODO로 남겨 둠).

실제 돈은 전자결제 신청 뒤 — 라이브는 계약 · 심사가 끝난 결제수단만

한 번에 정리하면

  • 클로드 코드에 "토스페이먼츠 결제위젯 붙여 줘. 테스트 키로." 한 줄이면 결제위젯 · 승인 서버 · 완료 화면까지 3분 38초 만에 만들어졌습니다(1회 측정).
  • 서버를 따로 말하지 않아도 만들었습니다. 결제 승인은 시크릿 키로 서버에서 해야 하기 때문입니다.
  • 막힌 곳은 결제 다음, '산 걸 어디서 받나'였습니다. 한 마디 더(2분 57초)로 승인된 주문에만 내려받기 링크가 생겼습니다.
  • 실제 돈은 전자결제 신청과 계약 · 심사 뒤에 받을 수 있습니다. 결제창까지는 딸깍이었지만, 수익화까지 딸깍은 아니었습니다.

특정 결제 서비스를 권하는 글이 아닙니다. 걸린 시간은 모델 · 상황에 따라 다를 수 있습니다.

출처

다음 글클로드 코드 사용법, CLAUDE.md에 이 한 줄→