Webshop Integration Guide
1. User Information Integration
You can expose a navigation path in the game that directs users to ONE webshop.
If the navigation URL includes the user’s game ID and server information, the Webshop automatically applies the ONE store login status and Purchase Input Information, allowing users to proceed with the purchase immediately.
If the game ID is considered personal information under your privacy policy, additional consent for third‑party data sharing may be required.
2. Server List Integration
When users enter the ONE webshop detail page, the Webshop retrieves and displays the game server list in real time.
If items must be delivered to a specific server, the developer must provide a Server List API. This API is called in real time on the Webshop detail page, and when the user completes a purchase, the selected server information is included in the PNS message.
The server list is displayed to users only if the following field is set during title registration:
Developer Center > Webshop > Main Info > Purchase Input Information = Purchase Identifier + Server
3. User Validation
Verifies whether the game ID and server information entered by the user are valid, and checks whether the item can be purchased.
Game ID is the value used to identify the final recipient (user or character) who will receive the item.In the Webshop, it is transmitted as
serviceUserId. (Depending on the game structure, it may be used as a UID or a Character ID.)
4. PNS (Payment Notification Service)
When a user completes a payment, the Webshop sends the payment result and related information to the game server via a PNS notification.
PNS supports both Commercial Environment and Sandbox Environment.
5. Confirm Purchases
To ensure that items are delivered correctly, the Confirm Purchases process must be completed.
Depending on your needs, you can use one of two APIs to perform Confirm Purchases.
consumePurchase
This is the commonly used method for Confirm Purchases.
After processing, the user can repurchase the same item.
acknowledgePurchase
Used for one-time items.
After processing, the user cannot repurchase the same item.
Notes
After item delivery, the Confirm Purchases process must be completed.
If Confirm Purchases is not completed within 3 days, the purchase is treated as undelivered and is automatically canceled.
Until Confirm Purchases is finished, the user cannot repurchase the same item.
TIP. Webshop Implementation Guide
After completing the ONE Webshop integration, please review key guidelines for live service operation, including store placement, navigation flow, UX, and operational considerations.
Last updated