운영·요금

사이트에 결제 붙였으면 오픈 전에 볼 3가지 — 토스페이먼츠 테스트 키, 결제 승인, 환불

테스트 키로는 결제 화면이 그대로 떠도 돈이 빠져나가지 않습니다. 오픈 전에 키가 test 인지 live 인지, 결제가 끝난 뒤 서버가 금액을 다시 확인하는지, 환불이 실제로 되는지 순서대로 봅니다.

#토스페이먼츠#결제 연동#테스트 키#환불

AI 로 만든 사이트에 결제를 붙였다면 오픈 전에 세 가지를 순서대로 봅니다. 결제 키가 테스트용인지 운영용인지, 결제가 끝난 뒤 서버가 결제사에 승인을 요청하면서 금액을 다시 맞춰 보는지, 그리고 환불이 실제로 되는지입니다. 셋 다 결제 화면만 봐서는 알 수 없는 것들입니다.

1. 테스트 키인지 운영 키인지

결제사는 연동할 때 테스트 키와 운영 키를 따로 줍니다. 테스트 키로 붙여 두면 결제 화면도 뜨고 “결제 완료”까지 진행되지만 돈은 들어오지 않습니다. 토스페이먼츠 문서에도 테스트 환경에서는 실제 카드 번호를 넣어도 “결제수단에서 금액이 차감되지 않아요”라고 적혀 있습니다.

키는 앞부분으로 구분합니다.

결제사테스트 키운영 키
토스페이먼츠 (결제위젯·결제창)test_gck, test_gsk 로 시작live_gck, live_gsk 로 시작
토스페이먼츠 (API 개별 연동)test_ck, test_sk 로 시작live_ck, live_sk 로 시작
Stripepk_test_, sk_test_ 로 시작pk_live_, sk_live_ 로 시작

확인은 이렇게 합니다.

  1. 배포한 곳(Vercel, Netlify 등)의 환경 변수 화면을 엽니다
  2. 결제 키 값의 앞부분이 test 인지 live 인지 봅니다
  3. 코드에 키가 직접 적혀 있을 수도 있으니 AI 에게 “결제 키가 어디에 들어 있는지 찾아 줘”라고 물어봅니다

토스페이먼츠는 전자결제 신청을 하고 나서야 운영 키를 확인할 수 있습니다. 신청 전이면 아직 테스트 키밖에 없으니, 오픈 일정보다 신청을 먼저 해 둡니다.

결제 키 앞부분으로 테스트와 운영을 구분하는 표: 토스페이먼츠 test_gck·test_ck 는 테스트, live_gck·live_ck 는 운영, Stripe pk_test_ 는 테스트, pk_live_ 는 운영

2. 결제가 끝난 뒤 서버가 승인하고 금액을 맞춰 보는지

토스페이먼츠는 고객이 결제창에서 결제를 마쳐도 그것만으로 끝나지 않습니다. 성공 주소로 돌아온 뒤 내 서버가 결제 승인 API 를 불러야 돈이 빠져나갑니다. 결제위젯 연동 문서에는 결제 요청 뒤 10분 안에 승인해야 한다고 적혀 있습니다.

이때 같이 봐야 하는 게 금액입니다. 성공 주소에 붙어 오는 금액은 브라우저를 거쳐 오기 때문에 바뀔 수 있습니다. 문서에도 돌아온 amount 값이 처음 요청한 금액과 같은지 “반드시 확인하세요”라고 되어 있습니다. 서버가 주문 금액을 다시 계산해서 맞춰 보지 않으면 10,000원짜리 상품을 100원에 결제하는 일이 생길 수 있습니다.

AI 에게는 이렇게 맡기면 됩니다.

결제 성공 뒤 서버에서 토스페이먼츠 결제 승인 API 를 부르는 코드가 있는지 확인해 주세요. 승인 전에 주문 금액을 서버에서 다시 계산해서 돌아온 amount 와 같은지 비교하고, 다르면 승인하지 않게 해 주세요.

결제 완료 알림(웹훅)을 받아서 주문을 처리하는 구조라면, 알림 내용만 믿지 말고 결제 조회 API 로 그 결제의 상태를 한 번 더 물어보는 쪽이 안전합니다.

3. 환불을 실제로 한 번 해 보기

테스트 키로 결제가 잘 되는 걸 봤어도 취소는 따로 만들어야 하는 기능입니다. 관리 화면에 환불 버튼이 있어도 결제사 취소 API 를 부르지 않고 주문 상태만 “취소”로 바꾸는 코드일 수 있습니다. 그러면 고객 카드에는 돈이 그대로 빠져나가 있습니다.

  1. 테스트 키 상태에서 결제를 하나 합니다
  2. 내 사이트 관리 화면에서 그 주문을 환불합니다
  3. 결제사 상점 관리자(토스페이먼츠는 개발자센터·상점관리자)에서 그 결제가 “취소”로 바뀌었는지 봅니다

운영 키로 바꾼 뒤에도 소액으로 한 번 결제하고 바로 취소해 보면, 실제 카드에서 승인과 취소 문자가 오는지까지 확인할 수 있습니다.

정리

순서볼 것어디서
1키가 test 인지 live 인지배포한 곳 환경 변수
2서버가 승인 API 를 부르고 금액을 다시 맞춰 보는지코드 (AI 에게 물어보기)
3환불이 결제사에서도 취소로 바뀌는지결제사 상점 관리자

결제 말고도 오픈 전에 볼 것들은 AI 로 만든 사이트, 오픈 전에 확인할 12가지에 모아 두었습니다.

2026년 11월 토스페이먼츠 API 키 문서, Stripe API keys 문서 기준입니다.

← 블로그 목록