---
title: "Server to Server 설정"
slug: "game-gamepot3server"
updated: 2026-09-17T09:07:47Z
published: 2026-09-17T09:07:47Z
canonical: "guide.ncloud-docs.com/game-gamepot3server"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Server to Server 설정

Classic/VPC 환경에서 이용 가능합니다.

아이템 지급, 로그인 검증을 위해 서버에서 서버로 요청을 발송하도록 설정하는 방법을 설명합니다.

## 결제 아이템 지급 요청

웹훅을 통해 HTTP 요청을 발송하여 결제 또는 쿠폰 사용에 따른 아이템 지급을 진행하도록 설정할 수 있습니다.

아이템 지급을 위해 웹훅으로 HTTP 요청을 발송하도록 설정하는 방법은 아래와 같습니다.

1. 관리자 계정으로 대시보드에 로그인해 주십시오.
2. **프로젝트 설정 > 일반** 메뉴를 차례대로 클릭해 주십시오.
3. **웹훅** 영역의 **아이템 구매 (운영)** 또는 **쿠폰 아이템 (운영)** 입력란에 아래 가이드를 참조하여 HTTP/ HTTPS URL 를 입력해 주십시오.
  - 결제 후 아이템 지급은 [결제 후 요청 및 응답](/docs/game-gamepot3server#%EA%B2%B0%EC%A0%9C%ED%9B%84%EC%9A%94%EC%B2%AD%EB%B0%8F%EC%9D%91%EB%8B%B5)을 참조해 주십시오.
  - 쿠폰 사용 후 아이템 지급은 [쿠폰 사용 후 요청 및 응답](/docs/game-gamepot3server#%EC%BF%A0%ED%8F%B0%EC%82%AC%EC%9A%A9%ED%9B%84%EC%9A%94%EC%B2%AD%EB%B0%8F%EC%9D%91%EB%8B%B5)을 참조해 주십시오.
  - 테스트 사용자에게 아이템을 지급하는 경우 **(테스트 사용자)** 표시가 있는 입력란에 요청을 입력해 주십시오.
4. **[저장]** 버튼을 클릭해 주십시오.

### 결제 후 요청 및 응답

아래 표 및 코드를 참조하여 HTTP 요청 및 응답을 설정해 주십시오.

- **요청**

```
https://{domain}?
userId={userId}&orderId={orderId}&projectId={projectId}&platform={platform}&productId={productId}&store={store}&payment={payment}&transactionId={transactionId}&gamepotOrderId={gamepotOrderId}&uniqueId={uniqueId}&tp={tp}&server_id={server_id}&player_id={player_id}&status={status}&remoteip={remoteip}&userdata={userdata}
```

| 속성 | 타입 | 최대 길이 | 설명 |
| --- | --- | --- | --- |
| `userId` | `String` | 128 | 사용자 ID |
| `transactionId` | `String` | 512 | 주문번호(GPA-xxxx-xxxx-) |
| `store` | `String` | 64 | 스토어 정보(`apple`, `google`, `one`) |
| `projectId` | `String` | 128 | 프로젝트ID |
| `productId` | `String` | 256 | 구글/애플/원스토어에 등록된 상품 ID |
| `platform` | `String` | 128 | 운영 Platform 정보 (`android`, `ios`) |
| `payment` | `String` | 64 | 결제 방식 |
| `uniqueId` | `String` | 512 | GAMEPOT에서 관리하는 Order ID |
| `gamepotOrderId` | `String` | 512 | GAMEPOT에서 관리하는 Order ID |
| `orderId` | `String` | 512 | GAMEPOT에서 관리하는 Order ID |
| `serverId` | `String` | - | serverId (setServerId api 호출 시 입력한 `serverId`) |
| `playerId` | `String` | - | playerId (setPlayerId api 호출 시 입력한 `playerId`) |
| `tp` | `Integer` | - | - 1: 테스트 결제 - 0: 일반 결제 |
| `remoteip` | `String` | - | IP 주소 |
| `userdata` | `String` | - | 사용자 데이터 (JSON 형식) - `{"player_id" : String, "server_id" : String, "metadata" : String, "options" : String}` - `player_id`: 플레이어 ID 값 (setPlayerId api 호출 시 입력한 `playerId`) - `server_id`: 서버 ID 값 (setServerId api 호출 시 입력한 `serverId`) - `metadata`: metadata (purchase 시 입력한 메타데이터 값) - `options`: options (purchase 시 입력한 추가 옵션 값) |
- **응답**

```
{
    "status": 1,
    "message" : ""
}
```

| 속성 | 타입 | 설명 |
| --- | --- | --- |
| `status` | `Integer` | 결괏값 - `0`: 실패, `1`: 성공 |
| `message` | `String` | 오류 내용 |

### 선물하기 및 쿠폰 사용 후 요청 및 응답

아래 표 및 코드를 참조하여 HTTP 요청 및 응답을 설정해 주십시오.

- **요청**

```
https://{domain}?
userId={userId}&projectId={projectId}&platform={platform}&store={store}&userData={userData}&itemId=[{itemData}, {itemData}, ...]&title={title}&content={content}&serverId={serverId}&playerId={playerId}
```

| 속성 | 타입 | 최대 길이 | 설명 |
| --- | --- | --- | --- |
| `userId` | `String` | 128 | 사용자 ID (대시보드에서 **게임 > 선물하기 > 대상** 값이 전체인 경우 `all` ) |
| `projectId` | `String` | 128 | 프로젝트 ID |
| `platform` | `String` | 128 | 운영 Platform 정보 (`android`, `ios`) |
| `store` | `String` | 64 | 스토어 정보(`apple`, `google`, `one`) |
| `title` | `String` | - | **대시보드 > 게임 > 선물 > 제목**에 입력한 값 |
| `content` | `String` | - | **대시보드 > 게임 > 선물 > 설명**에 입력한 값 |
| `target` | `String` | - | 게임팟 대시보드 > 게임 > 선물 > 대상 값 - 전체 : all / 사용자ID : user |
| `userData` | `String` | - | 클라이언트 SDK 쿠폰 API 호출 시 두 번째 파라미터에 입력한 값 또는 **대시보드 > 게임 > 선물 > UserData**에 입력한 값 |
| `serverId` | `String` | - | 서버 ID 값 (setServerId api 호출 시 입력한 `serverId`) |
| `playerId` | `String` | - | 플레이어 ID 값 (setPlayerId api 호출 시 입력한 `playerId`) |
| `itemId` | `Array` | - | itemData Array - `itemData(JSON) {"item_id" : String, "store_item_id" : String, "count" : Number}` - `item_id`: 대시보드 **게임 > 아이템**에서 생성한 아이템 항목의 고유 ID - `store_item_id`: 지급할 아이템 ID - `count`: 지급할 아이템 수 |
- **응답**

```
{
    "status": 1,
    "message" : ""
}
```

| 속성 | 타입 | 설명 |
| --- | --- | --- |
| `status` | `Integer` | 결괏값 - `0`: 실패, `1`: 성공 |
| `message` | `String` | 오류 내용 |