# Webshop Test

Before starting commercial sales, the Webshop allows you to verify screen configuration and payment flows using test accounts.

By registering a test ID according to the process, you can test Webshop functions without affecting the live service.

{% hint style="warning" %}
At least one Sandbox payment test is required to Start Selling.
{% endhint %}

{% hint style="info" %}
To perform payment tests successfully, required API integrations must be completed in advance. For details, refer to the [Webshop Integration Guide](https://onestore-dev.gitbook.io/dev/eng/tools/webshop).
{% endhint %}

***

## Test Environment Types <a href="#id" id="id"></a>

Webshop payment tests support both Sandbox Environment and Commercial Environment.

#### Sandbox Environment <a href="#id-sandbox" id="id-sandbox"></a>

* A virtual payment environment where no actual payment occurs.
* You can select either Payment Success or Payment Failure on the payment screen, and the selected response is returned as-is.
* At least one Sandbox payment test is mandatory to Start Selling.

#### Commercial Environment <a href="#id" id="id"></a>

* The actual payment screen shown to real users.
* Testing in this environment triggers real payments for the selected item, so proceed with caution.
* Cancellation is available in the Payment Test History menu.

{% stepper %}
{% step %}

## Register Test ID

To test Webshop functions, you must register a ONE store account as a Test ID.\
Test IDs can be registered in: `Developer Center > Webshop Test > Manage the Test IDs`

When registering a Test ID, select either Sandbox Environment or Commercial Environment.\
The payment screen shown during testing will match the environment you select.

<figure><img src="https://2218522982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgStyyzRzNh9x2u93ZH03%2Fuploads%2FElzc46PhfRsFzcSFL5Ae%2Fimage.png?alt=media&#x26;token=bb1312a9-eeed-442a-9669-0b5aee2e4611" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

## Enter the Webshop

Navigate to the Webshop of the title you want to test.\
You can access the Webshop either by using the URL directly or by clicking the `Go to ONE webshop` button at the bottom of the `Manage the Test IDs` menu.
{% endstep %}

{% step %}

## Test ID Login

Log in with the ONE store account registered as a Test ID to access the Webshop test page.

On the Webshop test screen, you can verify and purchase registered items.

{% hint style="info" %}
After successful login, the selected payment environment (Sandbox / Commercial) will be displayed at the top of the screen.
{% endhint %}

{% hint style="warning" %}
**Important Notice**

To run webshop tests, you must register items in advance.\
Entering the webshop test environment without any registered items may cause some features to function improperly.
{% endhint %}

<figure><img src="https://2218522982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgStyyzRzNh9x2u93ZH03%2Fuploads%2FzjY1xfl6tZrHRsci9v46%2Fimage.png?alt=media&#x26;token=4c670901-ee70-4173-8a1a-0d836e38628f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Run a Payment Test

When you initiate an item purchase on the Webshop test screen, the payment UI displayed will match the environment assigned to the Test ID.

{% hint style="warning" %}
At least one Sandbox payment test is required to Start Selling.
{% endhint %}

<figure><img src="https://2218522982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgStyyzRzNh9x2u93ZH03%2Fuploads%2Fx0tl6eIelP3j7hV83XFV%2Fimage.png?alt=media&#x26;token=7fb6def9-8540-428b-9977-34c5b9ab25d5" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## FAQ <a href="#id" id="id"></a>

<details>

<summary><strong>Q. Newly registered titles or items are not appearing on the test screen.</strong></summary>

It may take some time for newly registered titles or items to be reflected.\
Please re-enter the Developer Center or the Webshop test screen after a short wait.

If the information is still not displayed, please check whether items are registered.\
Entering the web shop test environment without any registered items may cause some features to function improperly.

</details>

<details>

<summary><strong>Q. Items in pre-sale status (Draft / Ready to Publish) are not appearing.</strong></summary>

The test screen displays pre-sale items (Draft / Ready to Publish) for preview.

If items are not visible, data synchronization may be delayed. Please check again after a short time.

</details>

<details>

<summary><strong>Q. Payment tests are not working properly.</strong></summary>

Required API integrations (Server List, User Validation) are needed for successful payment tests. Please verify that all required integrations are completed.

For more details, refer to the [Webshop Integration Guide](https://onestore-dev.gitbook.io/dev/eng/tools/webshop).

</details>

<details>

<summary><strong>Q. Sandbox or Commercial Test results are not showing in search</strong></summary>

To search Sandbox or Production Test results, please use the correct **Item ID** based on the criteria below:

* **Sandbox**
  * The identifier entered when registering the item (Item ID displayed in the Developer Center)
* **Commercial Test**
  * The `productId` provided via PNS

</details>