Sandbox — 실제 결제 없이 구축하고 테스트하기

모든 Kliv 스토어는 Sandbox에서 시작합니다. Sandbox는 테스트 결제를 사용하는, 완전하게 동작하는 상거래 백엔드입니다. 체크아웃, 구독, 환불, 결제 실패 등 모든 것이 실제 고객에게 적용될 때와 똑같이 실행되지만, 실제 돈은 오가지 않으며 시작하는 데 Stripe 계정이 필요하지 않습니다.

Sandbox가 기본값입니다. Kliv에 무언가를 판매하도록 요청하는 순간 이미 Sandbox에 있게 됩니다. 가입할 것도, 설정할 것도 없고, 실수로 누군가에게 결제가 청구될 위험도 없습니다.

Sandbox의 용도

실제 고객이 한 명이라도 오기 전에 스토어 전체를 구축하고 검증할 수 있습니다.

  • 카탈로그 구축 — 상품, 가격, 요금제, 가격 페이지.
  • 실제 체크아웃 실행 — 테스트 카드로 내 상품을 구매하고 주문이 나타나는 것을 확인합니다.
  • 구독 테스트 — 요금제를 시작하고, 전환하고, 취소하면서 청구가 어떻게 반응하는지 확인합니다.
  • 결제 실패 처리 확인 — 거절되는 카드를 사용해 Kliv가 재시도하고 고객에게 이메일을 보내는 과정을 확인합니다(독촉).
  • 환불 처리 — 환불과 승인 흐름을 처음부터 끝까지 실행합니다.

Sandbox는 실제 환경처럼 동작하므로, 여기서 동작하는 것은 라이브로 전환한 후에도 똑같이 동작합니다. 장난감 버전이 아니라 실제 스토어를 테스트하는 것입니다.

테스트 카드

Sandbox에서는 실제 카드 대신 테스트 카드 번호로 결제합니다. 각 번호는 테스트용으로 인식되며 정해진 결과를 만들어 내므로, 정상 결제, 거절, 추가 인증 단계 같은 모든 경우를 미리 연습할 수 있습니다. 실제 카드는 Sandbox에서 절대 동작하지 않으며(이 번호만 허용됩니다), 이 테스트 번호는 라이브에서도 누구에게도 결제를 청구하지 않습니다. Stripe를 연결한 후에는 Stripe 테스트 모드에서도 같은 번호를 사용할 수 있습니다.

모든 테스트 카드에는 미래의 아무 만료일, 아무 보안 코드(3자리, American Express는 4자리), 아무 우편번호를 입력하세요.

결제 성공

카드 번호 브랜드
4242 4242 4242 4242 Visa
4000 0566 5566 5556 Visa(체크카드)
5555 5555 5555 4444 Mastercard
5200 8282 8282 8210 Mastercard(체크카드)
3782 822463 10005 American Express
6011 1111 1111 1117 Discover
3566 0020 2036 0505 JCB
3056 9300 0902 0004 Diners Club
6200 0000 0000 0005 UnionPay

결제 거절

이 번호로 독촉의 재시도와 이메일을 포함해 결제 실패가 어떻게 처리되는지 확인할 수 있습니다.

카드 번호 결과
4000 0000 0000 0002 일반 거절
4000 0000 0000 9995 잔액 부족
4000 0000 0000 9987 분실 카드
4000 0000 0000 9979 도난 카드
4000 0000 0000 0069 만료된 카드
4000 0000 0000 0127 잘못된 보안 코드
4000 0000 0000 0119 처리 오류

추가 인증 필요(3-D Secure)

일부 카드는 은행이 때때로 요구하는 확인 단계를 발생시키므로 그 흐름도 테스트할 수 있습니다.

카드 번호 결과
4000 0025 0000 3155 인증을 요청한 후 성공
4000 0082 6000 3178 인증을 요청한 후 거절
4000 0000 3220 0000 자동으로 인증한 후 성공

테스트 카드와 실제 카드를 이렇게 분리한 것은 의도적입니다. 테스트하는 동안에는 실수로 실제 돈을 받는 일이 불가능합니다.

현재만이 아니라 미래도 미리 연습하기

Sandbox는 구매, 환불, 요금제 변경처럼 지금 일어나는 일을 테스트합니다. 다음 주에 끝나는 체험 기간, 다음 달에 갱신되는 구독, 세 번째 재시도에서 실패하는 카드처럼 시간이 지나면서 일어나는 일을 테스트하려면 Scenario를 포크하고 시계를 빨리 감으세요. 자세한 내용은 Scenario와 시간 여행에서 다룹니다.

Sandbox의 위치

Sandbox는 스토어가 실행될 수 있는 세 가지 환경 중 하나입니다. Sandbox 데이터, 테스트 데이터, 라이브 데이터는 완전히 분리되어 보관됩니다. 전체 구조는 환경 설명을 참고하세요.

실제 결제를 받을 준비가 되면 Stripe를 연결하고 라이브로 전환하세요. Sandbox에서 구축한 것은 하나도 사라지지 않습니다. 자세한 내용은 Stripe 연결 및 라이브 시작을 참고하세요.

요약

  • Sandbox는 테스트 결제를 사용하는 완전하게 동작하는 상거래 백엔드입니다. 기본값이며 Stripe 계정이 필요 없습니다.
  • 여기서 동작하는 것은 라이브에서도 똑같이 동작합니다.
  • 테스트 카드로 결제합니다(성공은 4242 4242 4242 4242). 실제 카드는 여기서 동작하지 않습니다.
  • 시간이 지나면서 일어나는 이벤트를 테스트하려면 Scenario를 포크하세요.