테스트 환경 설정하기

테스트 환경에 접근하고, 테스트 앱을 설치하는 방법을 알아보세요.

테스트 환경 접근 요청하기

토스쇼핑 테스트 환경에서는 가상 데이터로 주문과 결제를 해볼 수 있어요. 라이브 환경에 영향을 주지 않고 편안하게 연동 테스트를 할 수 있습니다. 테스트 환경의 운영 내역은 테스트 앱과 테스트용 토스쇼핑 파트너스에서 확인할 수 있어요.

이 링크로 아래 정보를 제출하면 테스트 환경 접근이 요청됩니다.

  • 테스트 환경과 연동할 서버 outbound IP 정보

  • 테스트 앱을 사용할 담당자 정보

테스트 환경 접근이 승인되면 테스트 앱 다운로드 링크와 테스트 앱 본인인증 번호, 테스트 상점 초대 링크을 메일로 보내드려요. 테스트 앱을 다운받고 담당자 계정을 만들어주세요.

테스트 앱 설치하기

테스트 환경에서의 운영 내역은 테스트 앱에서 확인할 수 있어요. 테스트 앱을 다운받고 설치하는 법을 알아보세요.

1

앱 다운로드 링크 열기

메일로 전달받은 테스트 앱 다운로드 링크를 휴대폰으로 접속해주세요. 테스트 환경 접근을 요청할 때 전달한 담당자 정보로 로그인해주세요.

2

기기 OS 선택하기

'시작하기' > 'Toss Core' > Android / iOS 에서 사용중인 기기의 OS를 선택해주세요.

3

테스트 앱 다운로드하기

맨 상단에 보이는 최신 버전의 테스트 앱을 다운로드해주세요. 버전 이름 우측에 '최신' 배지를 확인할 수 있어요.

4

다운로드한 앱 설치하기

테스트 앱 설치 방법은 운영체제에 따라 달라요.

  • iOS: 앱 센터에서 테스트 앱을 다운로드하면 자동으로 설치돼요.

실행 시 “신뢰할 수 없는 앱” 알림이 나와요.

설정 > 일반 > VPN 및 기기 관리 > 'Viva Republica Co, LTD을(를) 신뢰함' 을 클릭해주세요.

  • Android: ‘내 파일(앱)’ > 다운로드 에서 다운로드한 APK 파일을 눌러 설치해주세요.

출처를 알 수 없는 앱 설치 불가능 에러 메시지가 표시가 떠요.

디바이스 설정 > 보안 및 개인정보 보호 > 출처를 알 수 없는 앱 설치 > 내 파일 앱 스위치 ON 후 APK 를 다시 설치해주세요.

‘악성앱으로 의심!’이 떠요.

실제로 악성파일은 없어요. 디버그모드로 빌드가 된 APK 파일이라 보여주는 안내 페이지입니다.

테스트 앱 가입하기

테스트 앱 가입 절차는 토스 앱과 비슷지만 일부 절차가 더 간단해요.

1

본인인증 정보 입력하기

테스트 앱을 열어주세요. 안내에 따라 본인인증 정보를 적어주세요. 테스트 앱에 가입할 때는 본인 실명, 생년월일로 가입하는 것을 추천해요.

  • 실명, 생년월일이 다르면 추후에 조회가 어려울 수 있어요.

  • 다시 로그인할 때 같은 정보로 로그인해야 돼요. 이름, 주민등록번호, 통신사, 휴대폰번호 모두 가입할 때와 같은 정보여야 해요.

  • 테스트 환경에 이미 가입된 휴대폰번호는 쓸 수 없어요. 예를 들어, 010-1234-5678는 이미 다른 계정이 사용 중이에요.

2

문자인증 진행하기

테스트 앱의 문자인증은 실제로 발송되지 않아요. 테스트 환경 접근 승인 메일로 받은 본인인증 번호를 문자 인증란에 입력해주세요.

본인인증 번호는 만료되기 전까지 여러 번 사용할 수 있어요. 메일로 받은 본인인증 번호의 만료일자가 지나면 새롭게 발급하도록 요청해주세요.

3

'1원으로 인증하기'

테스트 앱에 가입할 때는 실제 '1원으로 인증하기'가는 이루어지지 않아요. 아무 은행이나 선택하고, 임의의 계좌번호를 입력해주세요. 인증번호 칸에는 000을 입력해 주세요.

4

인증전화 받기

인증전화 받기 버튼을 눌러도 실제로 전화가 오지는 않아요. 일정 시간이 지나면 ‘인증 완료’ 버튼이 나와요.

5

비밀번호 설정하기

비밀번호 입력 화면에 앞으로 사용할 비밀번호를 입력하세요. 비밀번호는 테스트앱에 다시 로그인할 때 필요해요. 잊어버리지 않게 주의해주세요.

6

테스트용 상점 접근하기

테스트 앱에 가입하면 테스트용 상점 초대 링크를 통해 테스트용 상점에 접근할 수 있어요. 테스트용 상점은 연동을 시험할 수 있도록 미리 준비되어있어요.

메일로 받은 테스트용 상점 초대에 로그인해주세요. 로그인할 때는 테스트앱으로 인증해야 해요. 꼭 테스트앱 가입 후 로그인을 시도해주세요.

테스트용 토스쇼핑 파트너스 주의사항

  • 테스트 환경에서는 최대 3초까지 시스템이 지연될 수 있어요. 반영이 안되는 경우에는 새로고침해주세요.

  • 테스트용 상점은 연동 업체간 공유해서 쓰는 상점이에요. 테스트가 겹칠 수 있음에 유의하여 기존 상품 삭제 등 영향을 주는 테스트는 지양해주세요.

  • 만약 공용 테스트 상점이 아닌 별도 테스트 상점이 필요하면 메일([email protected])로 문의주세요.

결제 테스트

테스트 상품 검수 요청하기

결제 및 주문 테스트를 위해 API 혹은 테스트 상점 페이지에서 상품 등록을 하는 경우, 별도로 검수 통과 요청을 보내주셔야해요.

이 경우, 메일 ([email protected])로 검수 통과가 필요한 상품에 대해 문의주시면 검수를 통과시켜드리고 있어요.

테스트 카드 등록하기

테스트 앱의 토스페이에 테스트용 Mock 카드를 추가해주세요. Mock 카드는 테스트 앱에서 결제 과정을 시험하는 모의 결제수단이에요.

1

테스트 앱 열기

테스트 앱에서 전체 > 토스페이 > 결제수단 > 추가로 이동해주세요.

2

Mock 카드 선택하기

결제수단 추가 화면에서 알파 Mock 카드 등록을 누르면 고를 수 있는 Mock 카드 목록이 보여요. 목록에서 카드를 선택하면 자동으로 결제수단에 등록돼요.

질문은 여기에 남겨주세요. 토스쇼핑 담당자가 확인하고 이메일로 답변드려요.

Previous반품 처리하기Next변경이력

Last updated