# 연동 관리

연동 관리 메뉴에서는 원웹샵과 게임 서버 간의 결제·검증·지급 과정에 필요한 **라이선스 정보, 인증 정보, 서버 URL 설정**을 관리합니다.

웹샵 연동의 핵심 기반이 되는 영역이므로 각 항목을 정확하게 구성해야 합니다.

***

## 1. 라이선스 관리

### 라이선스 키

PNS(Payment Notification Service)를 통해 전달되는 **결제 내역의 위변조 여부를 검증**하는 데 사용됩니다.

* PNS 전송 시, 원스토어는 결제 내역과 PublicKey(라이선스 키) 를 함께 전달합니다.
* 개발사는 전달된 PublicKey를 보관 중인 라이선스 키와 비교하여 데이터 무결성을 확인합니다.

### OAuth 인증 정보

원스토어 서버 API 호출 시 필요한 인증 정보를 제공합니다.

* **Client ID**
  * 원스토어 API 사용을 위한 고유 식별자입니다.
* **Client Secret**
  * API 인증 시 액세스 토큰을 발급받는 데 사용하는 보안 키입니다.
  * 매우 민감한 정보이므로 외부 노출 없이 안전하게 보관해야 합니다.

## 2. PNS 

* 원스토어가 결제 결과를 개발사 서버로 전달하는 데 사용되는 URL을 관리합니다.
* Sandbox / 상용 환경 각각 설정이 가능합니다.
* 상세 규격은 [PNS](/dev/tools/webshop/billing.md#pns) 가이드를 참고해주세요.

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

## 3. 유효성 검증 

* 사용자가 입력한 게임 ID, 서버 정보가 실제 존재하는지 검증하기 위한 서버 URL입니다.
* 웹샵은 구매 단계에서 사용자 입력 정보를 이 URL로 전송하여 결과를 확인합니다.
* 상세 규격은 [유효성 검증](/dev/tools/webshop/validation.md) 가이드를 참고하세요.

## 4. 서버 리스트 

* 원웹샵에서 사용자가 선택할 수 있는 **서버 목록**을 조회하기 위한 URL입니다.
* 웹샵 상세 화면에서 해당 URL을 실시간 호출하여 목록을 불러옵니다.
* 상세 규격은 [서버 리스트 연동](/dev/tools/webshop/server.md) 가이드를 참고하세요.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://onestore-dev.gitbook.io/dev/webshop/integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.