---
title: ZEPETO.Multiplay.Product
slug: world-sdk-guide-kr/zepetomultiplayproduct
docTags: 
createdAt: 2026-09-04T04:30:29.713Z
---

| 형식                                | 설명                                       |
| --------------------------------- | ---------------------------------------- |
| [ProductError](./#producterror)   | World 내 상품 관련 요청이 실패한 원인을 나타내는 오류 코드입니다. |
| [PurchaseType](./#purchasetype)   | World 내 상품의 구매 유형을 나타내는 열거형입니다.          |
| [ProductStatus](./#productstatus) | World 내 상품의 상태를 나타내는 열거형입니다.             |
| [ProductType](./#producttype)     | World 내 상품의 유형을 나타내는 열거형입니다.             |
| [ProductRecord](./#productrecord) | World 내 상품 정보입니다.                        |

## ProductError

`enum`

World 내 상품 관련 요청이 실패한 원인을 나타내는 오류 코드입니다.

| 이름           | 값  | 설명                                        |
| ------------ | -- | ----------------------------------------- |
| Unknown      | -1 | 오류: 알 수 없는 오류입니다.                         |
| NetworkError | 0  | 오류: 연결 끊김이나 불안정한 연결 등 네트워크 문제와 관련된 오류입니다. |

## PurchaseType

`enum`

World 내 상품의 구매 유형을 나타내는 열거형입니다.

| 이름            | 값                 | 설명                  |
| ------------- | ----------------- | ------------------- |
| Consumable    | "CONSUMABLE"      | 소모성 World 내 상품입니다.  |
| NonConsumable | "NON\_CONSUMABLE" | 비소모성 World 내 상품입니다. |

## ProductStatus

`enum`

World 내 상품의 상태를 나타내는 열거형입니다.

| 이름        | 값           | 설명                      |
| --------- | ----------- | ----------------------- |
| Active    | "ACTIVE"    | 활성 상태입니다.               |
| InActive  | "INACTIVE"  | 비활성 상태입니다.              |
| Forbidden | "FORBIDDEN" | 이용 기간 만료로 인해 금지된 상태입니다. |

## ProductType

`enum`

World 내 상품의 유형을 나타내는 열거형입니다.

| 이름              | 값                   | 설명                                  |
| --------------- | ------------------- | ----------------------------------- |
| Item            | "ITEM"              | 단일 아이템 World 내 상품입니다.               |
| ItemPackage     | "ITEM\_PACKAGE"     | 여러 아이템을 포함하는 아이템 패키지 World 내 상품입니다. |
| CurrencyPackage | "CURRENCY\_PACKAGE" | 여러 재화를 포함하는 재화 패키지 World 내 상품입니다.   |

## ProductRecord

`interface`

World 내 상품 정보입니다.

### 속성

| 이름                   | 형식                                                                  | 설명                                                          |
| -------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------- |
| productId            | `string`                                                            | World 내 상품 ID입니다.                                           |
| name                 | `string`                                                            | World 내 상품 이름입니다.                                           |
| price                | `number`                                                            | World 내 상품 가격입니다.                                           |
| purchaseType         | [PurchaseType](./#purchasetype)                                     | World 내 상품의 `PurchaseType`입니다.                              |
| status               | [ProductStatus](./#productstatus)                                   | World 내 상품의 `ProductStatus`입니다.                             |
| productType          | [ProductType](./#producttype)                                       | World 내 상품의 `ProductType`입니다.                               |
| currency             | `{ currencyId: string; name: string; isOfficialCurrency: boolean }` | World 내 상품 구매에 사용되는 재화의 종류를 반환합니다.                          |
| itemPackageUnits     | `{ productId: string; itemName: string; quantity: number }[]`       | `ProductType`이 `ItemPackage`인 경우 World 내 상품에 포함된 아이템입니다.    |
| currencyPackageUnits | `{ currencyId: string; currencyName: string; quantity: number }[]`  | `ProductType`이 `CurrencyPackage`인 경우 World 내 상품에 포함된 재화입니다. |