바이브 코딩 →

테스트 키·라이브 키Test Key / Live Key

테스트 키·라이브 키(Test Key / Live Key)는 연습용 모형 돈과 진짜 돈 같은 것 — 결제 API에서 실제 돈이 오가지 않는 개발용 키와 실제 결제를 처리하는 운영용 키를 나눈 것이에요.

테스트 키와 라이브 키는 소꿉놀이 가게의 모형 돈과 진짜 지갑에 든 돈의 차이와 비슷해요. 모형 돈으로는 계산대 흐름을 마음껏 연습해도 아무도 손해를 보지 않지만, 진짜 돈은 한 번 오가면 기록이 남고 환불 절차가 필요하죠. 결제 서비스도 똑같이 연습용 키(테스트 키)와 실제 결제용 키(라이브 키)를 따로 줘요.

강의에서는 토스페이먼츠 같은 결제 서비스를 사이트에 붙일 때 이 구분을 써요. 결제 심사를 받기 전에는 테스트 키로 결제창이 뜨는지, 결제 완료 후 주문이 저장되는지, 취소가 잘 되는지를 충분히 확인해요. 심사를 통과하면 Vercel의 환경 변수에 넣어 둔 키를 live가 붙은 라이브 키로 바꾸고 다시 배포해요. 그래서 '어디를 수정하나요?'에 대한 답은 코드가 아니라 배포 서비스의 환경 변수예요. 코드 안에 키를 직접 적어 두지 않았다면 키만 바꿔 끼우면 돼요.

초보가 자주 하는 실수는 키를 바꾼 뒤 재배포를 하지 않아 계속 테스트 결제가 되는 경우, 또는 클라이언트 키와 시크릿 키 중 하나만 바꿔 오류가 나는 경우예요. 두 키는 짝을 맞춰 함께 바꿔야 해요. 시크릿 키는 서버에서만 쓰고 화면 코드나 깃허브에 올리면 안 돼요. 라이브로 바꾼 뒤에는 소액으로 실제 결제와 환불을 한 번 해 보며 끝까지 확인하는 게 안전해요.

💡 대표 예시

  • 개발 단계 — 테스트 키로 결제·취소 흐름을 여러 번 돌려 본다
  • 심사 통과 후 — Vercel 환경 변수의 키를 live 키로 교체한다
  • 교체 후 — 재배포한 뒤 결제창에 테스트 표시가 사라졌는지 확인한다
  • 짝 맞추기 — 클라이언트 키와 시크릿 키를 같은 종류로 함께 바꾼다
  • 최종 점검 — 소액 실결제 후 바로 환불해 전체 흐름을 확인한다

🔗 관련 용어

환경변수

환경변수는 금고 열쇠를 별도 서랍에 보관하는 것 — 비밀번호·API 키 같은 민감 정보를 코드 안에 직접 쓰지 않고 별도 파일에 분리해서 관리하는 방식.

PG 결제대행

PG 결제대행 (Payment Gateway)은 가게와 카드사 사이의 중개인 같은 것 — 온라인 사이트에서 카드·간편결제를 받을 수 있게 카드사·은행과의 결제를 대신 연결하고 처리해 주는 서비스예요.

재배포

재배포(Redeploy)는 가게 간판 문구만 바꾸고 불을 다시 켜는 것 같은 것 — 코드는 그대로 두고, 바뀐 설정(환경 변수 등)을 반영하기 위해 사이트를 한 번 더 빌드해 배포하는 작업이에요.

시크릿(비밀키)

시크릿(Secrets)은 은행 금고에 맡겨 둔 열쇠 같은 것 — API 키·토큰·비밀번호처럼 노출되면 안 되는 값을 코드 밖의 안전한 보관소에 따로 저장해 두고 프로그램이 실행될 때만 꺼내 쓰게 하는 방식이에요.

토스페이먼츠

토스페이먼츠(Toss Payments)는 가게 계산대를 대신 설치해 주는 업체 같은 것 — 내 사이트에서 카드 결제·간편결제를 받을 수 있게 연결해 주는 결제대행(PG) 서비스예요.

Vercel(버셀)

Vercel(버셀)은 완성된 가게를 대신 열어 두는 상가 관리인 같은 것 — 깃허브에 올린 웹사이트 코드를 받아 누구나 접속할 수 있는 인터넷 주소로 24시간 배포·호스팅해 주는 서비스예요.

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.