> 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 연동이 사전에 준비되어 있어야 해요. 자세한 내용은 ONEshop 연동 가이드를 참고해 주세요.
  {% endhint %}

{% hint style="info" %}
웹샵 테스트는 원스토어 회원 계정(테스트 ID) 기반으로 제공돼요. 대한민국 외 국가의 결제와 비회원 결제는 결제 테스트를 할 수 없어요.
{% endhint %}

***

### 테스트 환경 종류

웹샵 결제 테스트는 개발환경(이하 Sandbox) 또는 상용 결제환경(이하 상용테스트)을 지원해요. 테스트 화면은 별도 환경이 아닌 상용 웹샵에서 제공되며, 테스트 ID에 설정한 결제 환경에 따라 결제 화면이 달라져요.

{% tabs %}
{% tab title="Sandbox" %}

* 실제 결제가 일어나지 않는 가상 결제환경이에요. 실제 서비스에 영향을 주지 않고 화면 구성과 결제 흐름을 확인할 수 있어요.
* 결제 화면에서 결제 성공 / 결제 실패 중 원하는 응답을 선택할 수 있으며, 선택한 응답이 그대로 결과로 전송돼요.
* 판매 국가에 '대한민국'이 포함된 경우, 검증 요청 전 Sandbox 결제 테스트 1회가 필수예요.
* 결제한 건은 `ONEconsole > Webshop > 주문 관리 > 테스트 결제 내역`에서 직접 취소할 수 있어요.
  {% endtab %}

{% tab title="상용테스트" %}

* 실제 사용자에게 제공되는 결제 화면이에요.
* 상용테스트로 결제하면 해당 아이템에 대해 **실제 결제가 일어나므로** 반드시 주의해 주세요.
* 테스트 ID로 결제한 건은 `ONEconsole > Webshop > 주문 관리 > 테스트 결제 내역`에서 직접 취소할 수 있어요.
* 테스트 ID가 아닌 일반 사용자의 결제 건은 원스토어 정책상 개발사가 직접 취소할 수 없어요. 취소가 필요한 경우 고객센터(CS)를 통해 문의해 주세요.
  {% endtab %}
  {% endtabs %}

***

### 테스트 진행 절차

{% stepper %}
{% step %}
**테스트 ID 등록**

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

* 국내 원스토어 계정만 등록할 수 있으며, 한 번에 최대 100개까지 등록할 수 있어요.
* 등록 시 결제 환경(Sandbox / 상용)을 선택할 수 있으며, 기본값은 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&#x26;token=0587a41d-d518-4c34-8a40-aab671fb20a3" alt="테스트 ID 등록 화면"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**웹샵 진입**

테스트를 진행할 타이틀의 웹샵으로 이동해요. 웹샵은 URL을 통해 직접 이동하거나, 테스트 ID 화면 오른쪽 위의 \[**웹샵으로 이동**] 버튼을 선택해 이동할 수 있어요.
{% endstep %}

{% step %}
**테스트 ID 로그인**

웹샵 화면에서 테스트 ID로 등록한 원스토어 계정으로 로그인하면, 화면 상단에 테스트 계정으로 로그인되었다는 안내 배너와 결제 환경이 표시돼요. 이 화면에서 판매 전 상태를 포함한 타이틀과 아이템을 확인하고 결제할 수 있어요.

{% 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&#x26;token=098f7b06-0278-4b10-a158-378dcd675a0c" alt="웹샵 테스트 로그인 화면"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**결제 테스트 진행**

웹샵 테스트 화면에서 아이템 구매를 요청하면, 테스트 ID에 설정된 결제 환경에 맞는 결제 화면이 노출돼요.
{% endstep %}

{% step %}
**결제 내역 확인 및 취소**

결제한 내역은 `ONEconsole > Webshop > 주문 관리 > 테스트 결제 내역`에서 상용테스트 / Sandbox를 전환해 확인할 수 있어요.

* 취소되지 않은 결제 건 중 금액이 0원보다 큰 건은 \[**구매취소**] 또는 여러 건 선택 후 \[**선택 구매취소**]로 직접 취소할 수 있어요.
* Sandbox 결제 건을 여러 건 취소하면 한 건씩 차례로 처리되며, 실패한 건에서 처리가 멈춰요.
* 조회 기간과 결제 일시는 UTC+0 기준이에요.

자세한 내용은 주문 관리를 참고해 주세요.
{% endstep %}
{% endstepper %}

### 자주 묻는 질문

<details>

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

타이틀과 아이템을 테스트 화면에 반영하는 과정에서 시간이 걸릴 수 있어요. 잠시 후 ONEconsole 또는 웹샵 테스트 화면에 다시 진입하면 정상적으로 노출돼요.

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

</details>

<details>

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

테스트 ID로 로그인하면 판매 전 상품(등록중, 판매대기)도 노출되어 미리 확인하고 결제할 수 있어요.

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

</details>

<details>

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

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

</details>

<details>

<summary><strong>Q. 대한민국 외 국가 판매나 비회원 결제도 테스트할 수 있나요?</strong></summary>

웹샵 테스트는 원스토어 회원 계정(테스트 ID) 기반으로 제공되므로, 대한민국 외 국가의 결제와 비회원 결제는 테스트할 수 없어요.

판매 국가에 대한민국이 없는 타이틀은 Sandbox 결제 테스트 없이 검증을 요청할 수 있어요.

</details>

<details>

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

`ONEconsole > Webshop > 주문 관리 > 테스트 결제 내역`에서 결제 환경별로 아래 항목으로 검색할 수 있어요.

* 상용테스트: 구매 ID, 주문 ID, 개발사 주문 ID, 테스트 ID
* Sandbox: 구매 ID, 구매 토큰, 테스트 ID, 아이템 ID

테스트 ID로 검색할 때는 목록에 마스킹되어 보이는 값이 아닌 **계정 ID 원문**을 정확히 입력해 주세요. 자세한 내용은 주문 관리를 참고해 주세요.

</details>