> 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/integration.md).

# 서버 연동

웹샵과 게임 서버 간의 결제·검증·지급 과정에 필요한 라이선스 정보, 인증 정보, 서버 URL을 관리해요. 웹샵 연동의 핵심 기반이 되는 영역이라 각 항목을 정확하게 구성해야 해요.

<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%2FFm220HL5pv8h4W2R7k0f%2Fimage.png?alt=media&amp;token=970d6009-1bca-46ba-8812-2aa4ccfaf9a6" alt=""><figcaption></figcaption></figure></div>

## 라이선스 관리

### 라이선스 키

PNS(Payment Notification Service)로 전달되는 결제 내역의 위변조 여부를 검증하는 데 사용돼요.

* 원스토어는 PNS 전송 시 결제 내역과 함께 PublicKey를 전달해요.
* 이 PublicKey가 여기 등록된 라이선스 키와 일치하는지 대조하면 데이터가 위변조되지 않았는지 확인할 수 있어요.

### OAuth 인증 정보

원스토어 서버 API를 호출할 때 필요한 인증 정보예요.

* **Client ID**
  * 원스토어 API 사용을 위한 고유 식별자예요.
* **Client Secret**
  * API 인증 시 액세스 토큰을 발급받는 데 사용하는 보안 키예요.

{% hint style="warning" %}
Client Secret은 매우 민감한 정보예요. 외부에 노출되지 않도록 안전하게 보관해 주세요.
{% endhint %}

***

## PNS&#x20;

* 원스토어가 결제 결과를 개발사 서버로 전달할 URL을 설정하는 곳으로, Sandbox와 상용 환경을 각각 따로 지정할 수 있어요
* **테스트 발송** 기능을 쓰면 지정한 URL에 테스트 메시지를 보내 정상적으로 수신되는지 바로 확인할 수 있어요.

  상세 규격은 \[[PNS 가이드](/dev/tools/webshop/billing.md#pns)]를 참고해 주세요.

{% hint style="info" %}
테스트 발송 기능을 통해 지정된 URL로 테스트 메시지를 발송해 정상 수신 여부를 확인할 수 있습니다.
{% endhint %}

***

## 유효성 검증&#x20;

사용자가 입력한 게임 ID, 서버 정보가 실제 존재하는지 확인하는 서버 URL이에요. 웹샵은 구매 단계에서 이 정보를 이 URL로 전송해 결과를 확인해요.

* 상세 규격은 \[[유효성 검증](/dev/tools/webshop/validation.md)]를 참고해 주세요.

***

## 서버 리스트&#x20;

웹샵에서 사용자가 선택할 수 있는 서버 목록을 조회하는 URL로, 웹샵 상세 화면에서 이 URL을 실시간 호출해 목록을 불러와요.

* 상세 규격은 \[[서버 리스트 연동 가이드](/dev/tools/webshop/server.md)]를 참고해 주세요.