> 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 결제 테스트가 필수입니다.
{% endhint %}

{% hint style="info" %}
결제 테스트가 정상적으로 이루어지려면 필수 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>

* 실제 사용자에게 제공되는 결제 화면입니다.
* 상용 환경에서 결제 테스트를 수행하면 해당 아이템에 대해 실제 결제가 일어나므로 반드시 주의해야 합니다.
* 결제 테스트 내역 메뉴에서 취소를 진행할 수 있습니다.

{% stepper %}
{% step %}

## 테스트 ID 등록

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

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

<figure><img src="/files/twGU5mnbRNPCRyUzRikj" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

## 웹샵 진입

테스트를 진행할 타이틀의 웹샵으로 이동합니다. \
웹샵은 URL을 통해 직접 이동 또는 테스트 ID 관리 메뉴 하단 `ONE webshop 바로가기`버튼을 선택해 이동할 수 있습니다.&#x20;
{% endstep %}

{% step %}

## 테스트 ID 로그인

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

웹샵 테스트 화면에서는 등록 중인 아이템을 확인하고 결제할 수 있습니다.

{% hint style="info" %}
등록된 테스트 ID를 성공적으로 로그인하면 화면 상단에 설정한 결제 환경 정보를 확인할 수 있습니다. (Sandbox / 상용)
{% endhint %}

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

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

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

{% step %}

## 결제 테스트 진행

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

{% hint style="warning" %}
웹샵 판매를 위해서는 최소 1회 Sandbox 결제 테스트가 필수입니다.
{% endhint %}

<figure><img src="/files/ItpYl21k1e8gBolgkyjV" alt=""><figcaption></figcaption></figure>
{% 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>