> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/webshop/test.md).

# 웹샵 테스트

웹샵은 정식 판매 이전에 테스트 계정을 활용해 화면 구성 및 결제 흐름을 검증할 수 있습니다. 절차에 따라 테스트 ID를 등록하면 웹샵 기능을 확인할 수 있습니다.

{% hint style="warning" %}
웹샵 판매를 위해서는 최소 1회 Sandbox 결제 테스트가 필수입니다.\
결제 테스트가 정상적으로 이루어지려면 필수 API 연동이 사전에 준비되어 있어야 합니다.\
자세한 내용은 [웹샵 연동 가이드](/dev/tools/webshop.md)를 참고해 주세요.
{% endhint %}

***

## 테스트 환경 종류 <a href="#id" id="id"></a>

웹샵 결제 테스트는 개발환경(이하 Sandbox) 또는 상용 결제환경(이하 상용테스트)를 지원합니다.

#### Sandbox 결제환경 <a href="#id-sandbox" id="id-sandbox"></a>

* 실제 결제가 일어나지 않는 가상 결제환경입니다. 실제 서비스에 영향을 주지 않고 화면 구성과 결제 흐름을 확인할 수 있습니다.
* 결제 화면에서 결제 성공 / 결제 실패 중 원하는 응답을 선택할 수 있으며, 선택한 응답이 그대로 결과로 전송됩니다.
* 웹샵 판매 등록을 위해서는 Sandbox 결제 테스트 1회가 필수입니다.
* 결제 테스트 내역 메뉴에서 직접 취소를 진행할 수 있습니다.

#### 상용 결제환경 <a href="#id" id="id"></a>

* 실제 사용자에게 제공되는 결제 화면입니다.
* 상용 환경에서 결제 테스트를 수행하면 해당 아이템에 대해 실제 결제가 일어나므로 반드시 주의해야 합니다.
* 원스토어 정책상 실제 결제 건은 개발사가 직접 취소할 수 없습니다. 취소가 필요한 경우 고객센터(CS)를 통해 문의해 주세요.

{% stepper %}
{% step %}

## 테스트 ID 등록

웹샵 기능을 테스트하려면 먼저 원스토어 회원 계정을 테스트 ID로 등록해야 합니다.\
테스트 ID는 개발자 > 테스트 ID 메뉴에서 등록할 수 있습니다.

테스트 ID 등록 시 Sandbox 또는 상용 결제 환경을 선택할 수 있으며, 결제 테스트 시 설정한 결제 환경에 맞는 결제 화면이 제공됩니다.

<div data-with-frame="true"><figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2Fk5HI8WGWOP7S8DBJhSLS%2Fimage.png?alt=media&amp;token=0587a41d-d518-4c34-8a40-aab671fb20a3" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

## 웹샵 진입

테스트를 진행할 타이틀의 웹샵으로 이동합니다.\
웹샵은 URL을 통해 직접 이동하거나, 테스트 ID 화면 상단의 \[웹샵 테스트 바로가기] 버튼을 선택해 이동할 수 있습니다.
{% endstep %}

{% step %}

## 테스트 ID 로그인

웹샵 화면에서 테스트 ID로 등록한 원스토어 계정으로 로그인하면 화면 상단에 "테스트 계정으로 로그인되어 있습니다.&#x20;

**"지금 아이템을 구매해 결제 테스트를 진행해 보세요."라는 안내 배너가 표시됩니다."**

이 화면에서 등록된 아이템을 확인하고 결제할 수 있습니다.

{% hint style="warning" %}
**유의사항**

웹샵 테스트를 진행하려면 **아이템을 먼저 등록해야 합니다.**\
아이템이 등록되지 않은 상태로 웹샵 테스트 환경에 진입할 경우, 일부 기능이 **정상적으로 동작하지 않을 수 있습니다.**
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FJd8U6Mz7T6lzzTby3iog%2Fimage.png?alt=media&amp;token=098f7b06-0278-4b10-a158-378dcd675a0c" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

## 결제 테스트 진행

웹샵 테스트 화면에서 아이템 구매 요청을 진행하면, 테스트 ID에 설정된 결제 환경에 맞게 결제 화면이 노출됩니다.

{% hint style="warning" %}
판매국가에 '대한민국'이 포함된 경우, 웹샵 판매를 위해서는 **최소 1회 Sandbox 결제 테스트가 필수**입니다.
{% endhint %}
{% endstep %}
{% endstepper %}

## 자주 묻는 질문 <a href="#id" id="id"></a>

<details>

<summary><strong>Q. 새로 등록한 타이틀 / 아이템이 테스트 화면에서 노출되지 않아요.</strong></summary>

타이틀과 아이템을 테스트 화면에 반영하는 과정에서 시간이 소요될 수 있습니다.\
잠시 후 개발자센터 또는 웹샵 테스트 화면에 다시 진입하면 정상적으로 노출됩니다.

또는 아이템이 등록되어 있는지 확인해 주세요. 아이템이 등록되지 않은 상태로 웹샵 테스트 환경에 진입할 경우, 일부 기능이 정상적으로 동작하지 않을 수 있습니다.

</details>

<details>

<summary><strong>Q. 판매 전(등록중,판매대기) 상태의 타이틀/아이템이 테스트 화면에서 노출되지 않아요.</strong></summary>

테스트 화면에서는 판매 전 상품(등록중,판매대기)도 노출되어 미리 확인할 수 있습니다.&#x20;

만약 타이틀 또는 아이템이 보이지 않을 경우, 데이터 반영이 지연될 수 있으니 잠시 후 다시 확인해 주세요.

</details>

<details>

<summary><strong>Q. 구매 테스트가 정상적으로 진행되지 않아요.</strong></summary>

원활한 구매 테스트를 위해 필수 API 연동(서버 리스트∙유효성 검증 API)이 필요합니다. \
누락된 항목이 있는지 다시 확인해 주세요.

자세한 내용은 [웹샵 연동 가이드](/dev/tools/webshop.md)를 참고해 주세요.

</details>

<details>

<summary><strong>Q. Sandbox 또는 상용 테스트 내역이 검색되지 않아요.</strong></summary>

Sandbox와 상용 테스트 결과를 검색하려면, 아래 기준에 맞는 ‘아이템 ID’로 조회해주세요.

* Sandbox&#x20;
  * 아이템 등록 시입력한 식별값 (개발자센터에 표기되어 있는 아이템 ID)&#x20;
* 상용테스트&#x20;
  * PNS를 통해 전달 받은 `productId`

</details>