테스트 키·라이브 키(Test Key / Live Key)는 연습용 모형 돈과 진짜 돈 같은 것 — 결제 API에서 실제 돈이 오가지 않는 개발용 키와 실제 결제를 처리하는 운영용 키를 나눈 것이에요.
테스트 키와 라이브 키는 소꿉놀이 가게의 모형 돈과 진짜 지갑에 든 돈의 차이와 비슷해요. 모형 돈으로는 계산대 흐름을 마음껏 연습해도 아무도 손해를 보지 않지만, 진짜 돈은 한 번 오가면 기록이 남고 환불 절차가 필요하죠. 결제 서비스도 똑같이 연습용 키(테스트 키)와 실제 결제용 키(라이브 키)를 따로 줘요.
강의에서는 토스페이먼츠 같은 결제 서비스를 사이트에 붙일 때 이 구분을 써요. 결제 심사를 받기 전에는 테스트 키로 결제창이 뜨는지, 결제 완료 후 주문이 저장되는지, 취소가 잘 되는지를 충분히 확인해요. 심사를 통과하면 Vercel의 환경 변수에 넣어 둔 키를 live가 붙은 라이브 키로 바꾸고 다시 배포해요. 그래서 '어디를 수정하나요?'에 대한 답은 코드가 아니라 배포 서비스의 환경 변수예요. 코드 안에 키를 직접 적어 두지 않았다면 키만 바꿔 끼우면 돼요.
초보가 자주 하는 실수는 키를 바꾼 뒤 재배포를 하지 않아 계속 테스트 결제가 되는 경우, 또는 클라이언트 키와 시크릿 키 중 하나만 바꿔 오류가 나는 경우예요. 두 키는 짝을 맞춰 함께 바꿔야 해요. 시크릿 키는 서버에서만 쓰고 화면 코드나 깃허브에 올리면 안 돼요. 라이브로 바꾼 뒤에는 소액으로 실제 결제와 환불을 한 번 해 보며 끝까지 확인하는 게 안전해요.
AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.