---
title: ZEPETO.Multiplay.Currency
slug: world-sdk-guide-kr/zepetomultiplaycurrency
docTags: 
createdAt: 2026-09-04T06:07:53.489Z
---

| 형식                                | 설명                                          |
| --------------------------------- | ------------------------------------------- |
| [CurrencyError](./#currencyerror) | World 내 재화 관련 요청이 실패한 원인을 나타내는 오류 코드입니다.    |
| [Currency](./#currency)           | `Currency`는 ZEPETO World 재화와 관련된 작업을 관리합니다. |

## CurrencyError

`enum`

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

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

## Currency

`interface`

`Currency`는 ZEPETO World 재화와 관련된 작업을 관리합니다.

### 메서드

### debit

`debit(id: string, quantity?: number, reason?: string) → Promise<boolean>`

플레이어의 World 내 재화 잔액에서 지정한 수량을 차감합니다. `CurrencyError`를 발생시킵니다.

| 매개변수             | 형식       | 설명                          |
| ---------------- | -------- | --------------------------- |
| id               | `string` | 차감할 재화의 ID입니다.              |
| quantity (선택 사항) | `number` | 차감할 재화의 수량입니다. 기본값은 `1`입니다. |
| reason (선택 사항)   | `string` | 차감 사유를 선택적으로 기술합니다.         |

**반환값:** `Promise<boolean>` — 작업 완료 시 이행되는 `Promise`이며, 성공(`true`) 또는 실패(`false`)를 나타냅니다.

### credit

`credit(id: string, quantity?: number, reason?: string) → Promise<boolean>`

플레이어의 World 내 재화 잔액에 지정한 수량을 증가시킵니다. `CurrencyError`를 발생시킵니다.

| 매개변수             | 형식       | 설명                           |
| ---------------- | -------- | ---------------------------- |
| id               | `string` | 증가시킬 재화의 ID입니다.              |
| quantity (선택 사항) | `number` | 증가시킬 재화의 수량입니다. 기본값은 `1`입니다. |
| reason (선택 사항)   | `string` | 증가 사유를 선택적으로 기술합니다.          |

**반환값:** `Promise<boolean>` — 작업 완료 시 이행되는 `Promise`이며, 성공(`true`) 또는 실패(`false`)를 나타냅니다.

### getBalance

`getBalance(id: string) → Promise<number>`

플레이어의 World 내 재화 잔액을 가져옵니다. `CurrencyError`를 발생시킵니다.

| 매개변수 | 형식       | 설명             |
| ---- | -------- | -------------- |
| id   | `string` | 가져올 재화의 ID입니다. |

**반환값:** `Promise<number>` — 작업 완료 시 가져온 잔액과 함께 이행되는 `Promise`입니다.

### getBalances

`getBalances() → Promise<{ [key: string]: number }>`

플레이어가 보유한 각 World 내 재화의 잔액을 가져옵니다. `CurrencyError`를 발생시킵니다.

**반환값:** `Promise<{ [key: string]: number }>` — 작업 완료 시 각 World 내 재화 ID를 키로, 해당 잔액을 값으로 갖는 객체와 함께 이행되는 `Promise`입니다.