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 등 외부에 노출되면 안 됩니다"라고 적혀 있습니다. 브라우저에 시크릿 키를 둘 수 없으니 서버가 필요한 것이죠.

클로드가 만든 server.js는 패키지 설치 없이 도는 Node 서버였고, 세 가지를 하고 있었습니다.
- 상품 가격을 서버가 정하고, 결제 전에 주문(주문번호 · 금액)을 만들어 둔다.
- 결제 뒤 돌아오면 금액이 그 주문과 같은지 확인한다(브라우저에서 금액을 바꿔 결제하는 것을 막기 위해).
- 시크릿 키로 결제 승인 API를 부른다. 실제 키는 코드에 넣지 말고 환경 변수
TOSS_SECRET_KEY로 넘기라고 안내했다.
가이드에는 승인을 부르지 않으면 "아직 결제 요청 중"이라 결제가 완료되지 않는다는 설명과, 결제 요청 뒤 10분 안에 승인해야 한다는 주의도 있습니다. 결제창만 띄우고 승인 단계를 빼먹으면 돈이 안 들어오는 이유가 여기 있습니다.
그럼 어디서 막혔나요?
결제가 끝난 다음이었습니다. '결제를 완료했어요' 화면에는 상품 · 금액 · 주문번호만 있고, 정작 산 PDF를 받을 곳이 없었습니다. 클로드도 작업 보고 끝에 "결제가 승인된 뒤 PDF 다운로드 권한을 주는 부분은 아직 없습니다"라고 적어 두긴 했는데, 보고를 꼼꼼히 읽지 않으면 놓치기 쉬운 한 줄이었습니다.

디지털 상품을 파는 페이지라면 결제창보다 이 부분이 더 중요합니다. 손님 입장에서는 돈을 냈는데 받을 게 없는 상황이니까요.
한 마디 더 하면 해결되나요?
네, 같은 대화에 이어서 이렇게 보냈습니다.
결제 완료 화면은 뜨는데, 산 PDF를 받을 곳이 없어. 결제가 승인되면 바로 PDF 내려받기 되게 해 줘.
2분 57초(177초) 뒤 결제 완료 화면에 'PDF 내려받기' 칸이 생겼습니다. 승인된 주문에만 그 주문 전용 내려받기 링크가 만들어지고, 링크는 24시간 동안 쓸 수 있습니다. 결제 없이 파일 주소로 바로 들어가거나 틀린 링크를 쓰면 막히게(404) 해 뒀고, 완료 화면에 들어오면 A4 파일이 바로 내려받아지기 시작합니다. 판매할 PDF 원본이 없어서 'SAMPLE'이라고만 적힌 임시 파일 두 개(A4 · A5)를 files/ 폴더에 넣어 뒀으니, 실제 파일로 덮어쓰라는 안내도 있었습니다.

같은 테스트 결제를 처음부터 다시 해 보니 완료 화면에서 A4 파일 내려받기가 실제로 시작됐습니다.
| 순서 | 보낸 말 | 걸린 시간 | 결과 |
|---|---|---|---|
| 1 | 토스페이먼츠 결제위젯 붙여 줘. 테스트 키로. | 3분 38초 | 결제위젯 · 승인 서버 · 완료/실패 화면, 테스트 결제 완료 |
| 2 | 승인되면 바로 PDF 내려받기 되게 해 줘 | 2분 57초 | 승인된 주문에만 24시간 내려받기 링크 |
claude -p 결과에 찍힌 사용량 환산값(total_cost_usd)은 1번 약 0.96달러, 2번 약 1.69달러였습니다. 구독 요금제인지 API 결제인지에 따라 실제 청구 방식은 다릅니다.
이대로 실제 돈을 받을 수 있나요?
아니요. 지금 것은 테스트라 돈이 빠져나가지 않습니다. 토스페이먼츠 가이드에는 "테스트 환경에서는 결제가 가상으로만 이뤄지기 때문에 결제수단에서 금액이 차감되지 않아요"라고 적혀 있습니다. 실제 결제를 받으려면 순서가 하나 더 있습니다.
- 전자결제 신청: 가이드에 따르면 결제 연동 키(실제 키)는 "토스페이먼츠 전자결제 신청 이후에만 확인할 수 있"습니다. 신청 전에는 테스트 키로만 연동해 볼 수 있습니다.
- 계약 · 심사: 토스페이먼츠 블로그(2026.11.01)는 "라이브 환경에서는 계약과 심사가 완료된 결제수단만 정상적으로 이용할 수" 있다고 안내합니다.
- 실제 키로 바꾸기: 클라이언트 키는
index.html에서, 시크릿 키는 코드가 아니라 환경 변수로 넘깁니다. - 주문 저장소 바꾸기: 이번 코드는 주문 · 내려받기 링크를 메모리에만 저장해서 서버를 다시 켜면 사라집니다. 실제로 팔기 전에는 데이터베이스 저장이나 결제 뒤 링크를 메일로 보내는 기능이 필요합니다(클로드가 TODO로 남겨 둠).

한 번에 정리하면
- 클로드 코드에 "토스페이먼츠 결제위젯 붙여 줘. 테스트 키로." 한 줄이면 결제위젯 · 승인 서버 · 완료 화면까지 3분 38초 만에 만들어졌습니다(1회 측정).
- 서버를 따로 말하지 않아도 만들었습니다. 결제 승인은 시크릿 키로 서버에서 해야 하기 때문입니다.
- 막힌 곳은 결제 다음, '산 걸 어디서 받나'였습니다. 한 마디 더(2분 57초)로 승인된 주문에만 내려받기 링크가 생겼습니다.
- 실제 돈은 전자결제 신청과 계약 · 심사 뒤에 받을 수 있습니다. 결제창까지는 딸깍이었지만, 수익화까지 딸깍은 아니었습니다.
특정 결제 서비스를 권하는 글이 아닙니다. 걸린 시간은 모델 · 상황에 따라 다를 수 있습니다.
출처
- 토스페이먼츠 결제위젯 연동 가이드(연동 순서 · 결제 승인 API · 테스트 키 · 시크릿 키 주의, 2026년 11월 12일 확인): https://docs.tosspayments.com/guides/payment-widget/integration
- 토스페이먼츠 블로그(테스트 · 라이브 API 키, 2026.11.01): https://www.tosspayments.com/blog/articles/54511
- 토스페이먼츠 블로그(샌드박스, 2026.11.01): https://www.tosspayments.com/blog/articles/54513
- 직접 시험(2026.11.12): 클로드 코드 2.1.322 · 가상 상품 페이지 · 문서용 테스트 키
- 영상: AItoZ 유튜브 쇼츠 '토스 결제창 바이브코딩으로 붙여 보니'
