테스트 환경

토스페이먼츠의 테스트 환경은 개발과정에서 결제 과정을 동일하게 경험하면서 실제 금액은 지불하지 않도록 지원하는 환경입니다. 홈페이지에 가입하지 않아도, 사업자등록번호가 아직 없어도 테스트 환경에서 결제 연동을 진행해 볼 수 있어요.

시작하기 전에

테스트 키 준비

토스페이먼츠 계정이 없어도 테스트 키로 연동을 바로 시작할 수 있습니다. 연동 개발을 마친 뒤 테스트 키를 라이브 키로 변경하면 실제로 결제가 됩니다. 더 자세한 내용은 API 사용하기를 확인하세요.

테스트 결제창

테스트 API 키를 사용하면 테스트 결제창이 열립니다. 테스트 결제창 왼쪽 위에 '실제 결제가 되지 않는 테스트입니다.'라는 안내 문구를 볼 수 있습니다.

가상 결제승인

테스트 환경에서는 신용카드 정보나 휴대폰 번호와 같은 실제 정보를 이용해서 결제해도 결제승인은 가상으로 이루어집니다. 따라서 결제승인 요청에 대한 응답이 성공으로 돌아오더라도 빠져나가는 금액은 없습니다.

라이브 환경과 다른 경우 알아보기

테스트 환경에서 API 사용, 인증 과정, 지원하는 결제수단 등이 라이브 환경과 다른 경우를 알아봅니다.

결제수단 등록 과정

  • 카드번호

    테스트 환경에서 카드 자동결제를 등록할 때는 카드번호의 앞 여섯자리(BIN 번호)만 유효해도 자동결제가 등록됩니다. 라이브 환경에서는 전체 카드번호가 유효해야 등록이 가능합니다.

  • 휴대폰 인증

    테스트 환경에서 카드 자동결제를 등록할 때는 휴대폰 본인인증 과정을 거치지 않습니다. 휴대폰 인증은 라이브 환경에서만 사용할 수 있습니다.

계좌이체 정보 인증 생략

계좌번호, 비밀번호, 계좌 소유주 이름, 보안카드와 OTP 정보를 가상의 값으로 넣어 테스트 할 수 있습니다. 다만 사용자의 공동 인증서는 실제로 인증이 되어야 합니다.

휴대폰 결제 테스트 미제공

테스트 환경의 휴대폰 결제는 본인인증 서비스를 사용할 수 없어 결제 과정을 끝까지 진행할 수 없습니다. 휴대폰 본인인증 서비스가 가능한 라이브 환경에서 전체 결제 과정을 진행해보세요.

가상의 상품권 PIN 번호 사용시 금액 정보 고정

게임 문화 상품권 결제 테스트에서 실제 PIN 번호가 아닌 가상의 값을 넣어 테스트 할 수 있습니다. 사용 가능한 금액으로는 항상 10,000원을 보여줍니다.

간편결제 결제수단 제한

테스트 환경에서는 간편결제 수단으로 토스 간편결제만 제공합니다. 기타 다른 간편결제(삼성페이, 페이코 등)은 라이브 환경에서 테스트 할 수 있습니다.

영수증 발행 제한

테스트 환경에서 이루어진 결제의 매출전표(영수증)와 현금영수증은 발행되지 않습니다.

매출전표는 Payment 객체 하위의 card > receiptUrl, 현금영수증은 cashReceipt > receiptUrl 필드에 링크가 생성되지만 실제로 확인할 수 있는 데이터는 제공되지 않습니다.

정산기록 조회 제한

정산조회 API의 응답으로 돌아오는 정산기록은 라이브 환경에서만 조회할 수 있습니다. 테스트 환경에서는 정산 배치(Batch, 일괄처리) 프로그램이 실행되지 않아 정산기록이 없는 것으로 조회됩니다.

가상계좌 입금・취소 액션 제공

테스트 환경에서 발급된 계좌 정보로 직접 입금할 수 없지만, 토스페이먼츠 홈페이지 > 내 상점 > 개발 정보 > 테스트 거래내역 확인에서 제공하는 입금・취소 이벤트를 실행하면 실제 동작과 동일하게 테스트 할 수 있습니다.

가장 오른쪽 액션 컬럼의 액션 > 입금처리/취소를 선택해보세요.

테스트 거래 내역
  • 더 궁금한 내용이 있나요?자주 묻는 질문
  • 코드 샘플을 참고하세요TossPayments GitHub
  • 기술지원이 필요한가요?디스코드 채팅|이메일 보내기