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

| Tipe                              | Deskripsi                                                                             |
| --------------------------------- | ------------------------------------------------------------------------------------- |
| [CurrencyError](./#currencyerror) | Kode error yang menunjukkan penyebab kegagalan permintaan terkait mata uang in-World. |
| [Currency](./#currency)           | `Currency` mengelola operasi yang berkaitan dengan mata uang ZEPETO World.            |

## CurrencyError

`enum`

Kode error yang menunjukkan penyebab kegagalan permintaan terkait mata uang in-World.

| Nama         | Nilai | Deskripsi                                                                                       |
| ------------ | ----- | ----------------------------------------------------------------------------------------------- |
| Unknown      | -1    | Error: Kesalahan tidak dikenal.                                                                 |
| NetworkError | 0     | Error: Kesalahan terkait masalah jaringan, termasuk koneksi terputus atau koneksi tidak stabil. |

## Currency

`interface`

`Currency` mengelola operasi yang berkaitan dengan mata uang ZEPETO World.

### Metode

### debit

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

Mengurangi jumlah yang ditentukan dari saldo mata uang in-World milik pemain. Melempar `CurrencyError`.

| Parameter           | Tipe     | Deskripsi                                                          |
| ------------------- | -------- | ------------------------------------------------------------------ |
| id                  | `string` | ID mata uang yang akan dikurangi.                                  |
| quantity (opsional) | `number` | Jumlah mata uang yang akan dikurangi. Nilai defaultnya adalah `1`. |
| reason (opsional)   | `string` | Secara opsional menjelaskan alasan pengurangan.                    |

**Mengembalikan:** `Promise<boolean>` — `Promise` yang selesai setelah proses berakhir, menunjukkan keberhasilan (`true`) atau kegagalan (`false`).

### credit

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

Menambah saldo mata uang in-World milik pemain sebesar jumlah yang ditentukan. Melempar `CurrencyError`.

| Parameter           | Tipe     | Deskripsi                                                         |
| ------------------- | -------- | ----------------------------------------------------------------- |
| id                  | `string` | ID mata uang yang akan ditambah.                                  |
| quantity (opsional) | `number` | Jumlah mata uang yang akan ditambah. Nilai defaultnya adalah `1`. |
| reason (opsional)   | `string` | Secara opsional menjelaskan alasan penambahan.                    |

**Mengembalikan:** `Promise<boolean>` — `Promise` yang selesai setelah proses berakhir, menunjukkan keberhasilan (`true`) atau kegagalan (`false`).

### getBalance

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

Mengambil saldo mata uang in-World milik pemain. Melempar `CurrencyError`.

| Parameter | Tipe     | Deskripsi                       |
| --------- | -------- | ------------------------------- |
| id        | `string` | ID mata uang yang akan diambil. |

**Mengembalikan:** `Promise<number>` — `Promise` yang selesai setelah proses berakhir, dengan jumlah saldo yang diambil.

### getBalances

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

Mengambil saldo dari setiap mata uang in-World yang dimiliki pemain. Melempar `CurrencyError`.

**Mengembalikan:** `Promise<{ [key: string]: number }>` — `Promise` yang selesai setelah proses berakhir, dengan objek yang setiap kuncinya adalah ID mata uang in-World dan nilainya adalah saldo yang bersangkutan.