# 테스트 환경 설정하기

## 테스트 환경 접근 요청하기

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

[이 링크](https://docs.google.com/forms/d/e/1FAIpQLSes_okYvOGVfNAZWHttFDE8kreDw4Rv8Trz_AnpeqePx04y3Q/viewform)로 아래 정보를 제출하면 테스트 환경 접근이 요청됩니다.

* 테스트 환경과 연동할 서버 outbound IP 정보
* 테스트 앱을 사용할 담당자 정보

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

## 테스트 앱 설치하기

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

{% stepper %}
{% step %}

### 앱 다운로드 링크 열기

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

{% step %}

### 기기 OS 선택하기

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

<figure><img src="/files/02XxKhewg8qqCHdtAzIx" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 테스트 앱 다운로드하기

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

<figure><img src="/files/LIBNVuuo3HLMxvic7jRs" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 다운로드한 앱 설치하기

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

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

{% hint style="info" %}
**실행 시 “신뢰할 수 없는 앱” 알림이 나와요.**

**설정 > 일반 > VPN 및 기기 관리 > 'Viva Republica Co, LTD을(를) 신뢰함**' 을 클릭해주세요.&#x20;
{% endhint %}

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

{% hint style="info" %}
**출처를 알 수 없는 앱 설치 불가능 에러 메시지가 표시가 떠요.**&#x20;

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

{% hint style="info" %}
**‘악성앱으로 의심!’이 떠요.**&#x20;

실제로 악성파일은 없어요.  디버그모드로 빌드가 된 APK 파일이라 보여주는 안내 페이지입니다.&#x20;
{% endhint %}
{% endstep %}
{% endstepper %}

## 테스트 앱 가입하기

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

{% stepper %}
{% step %}

### 본인인증 정보 입력하기

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

* 실명, 생년월일이 다르면 추후에 조회가 어려울 수 있어요.&#x20;
* 다시 로그인할 때 **같은 정보로** 로그인해야 돼요. 이름, 주민등록번호, 통신사, 휴대폰번호 모두 가입할 때와 같은 정보여야 해요.
* 테스트 환경에 이미 가입된 휴대폰번호는 쓸 수 없어요. 예를 들어, 010-1234-5678는 이미 다른 계정이 사용 중이에요.&#x20;

<figure><img src="/files/OCfomYo7Q73xN6X6kZg9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 문자인증 진행하기

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

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

<figure><img src="/files/n6I04MjUSxx60m2BJEZv" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **'1원으로 인증하기'**&#x20;

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

<figure><img src="/files/vvkF3Ju6qgafurnmAqWy" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 인증전화 받기

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

{% step %}

### 비밀번호 설정하기&#x20;

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

{% step %}

### 테스트용 상점 접근하기

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

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

{% hint style="info" %}
테스트용 토스쇼핑 파트너스 주의사항

* 테스트 환경에서는 최대 3초까지 시스템이 지연될 수 있어요. 반영이 안되는 경우에는 새로고침해주세요.
* 테스트용 상점은 연동 업체간 공유해서 쓰는 상점이에요. 테스트가 겹칠 수 있음에 유의하여 기존 상품 삭제 등 영향을 주는 테스트는 지양해주세요.
* 만약 공용 테스트 상점이 아닌 별도 테스트 상점이 필요하면 메일(<toss-shopping-partners-connect@toss.im>)로 문의주세요.
  {% endhint %}
  {% endstep %}
  {% endstepper %}

## 결제 테스트

### 테스트 상품 검수 요청하기

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

이 경우, 메일 (<toss-shopping-partners-connect@toss.im>)로 검수 통과가 필요한 상품에 대해 문의주시면 검수를 통과시켜드리고 있어요.

### 테스트 카드 등록하기

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

{% stepper %}
{% step %}

#### 테스트 앱 열기

테스트 앱에서 **전체 > 토스페이 > 결제수단 > 추가**로 이동해주세요.&#x20;
{% endstep %}

{% step %}

#### Mock 카드 선택하기

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

<figure><img src="/files/FtlZIteCGG65q5ffwIlC" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

> ### API 연동 중 문의사항이나 개선 제안이 있으신가요?

{% hint style="info" %}
토스쇼핑 API 연동에 대한 질문이나, 건의사항이 있다면 [연동/개발 문의](https://discord.gg/xPz6H9NZ3P)에 남겨주세요. 다른 유저의 문의를 참고하거나, 토스쇼핑 담당자와 질의를 주고 받을 수 있어요.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://shopping-docs.toss.im/dev/api-1/test.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.