---
title: ZEPETO.Currency
slug: world-sdk-guide-id/zepetocurrency
docTags: 
createdAt: 2026-09-04T05:53:24.459Z
---

| Tipe                                          | Deskripsi                                                                                                                                                                                                    |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [BalanceRecord](./#balancerecord)             | Informasi saldo untuk mata uang tertentu.                                                                                                                                                                    |
| [BalanceResponse](./#balanceresponse)         | Class `BalanceResponse` menyediakan hasil pemanggilan API dan informasi saldo.                                                                                                                               |
| [BalanceListResponse](./#balancelistresponse) | Class `BalanceListResponse` menyediakan hasil pemanggilan API dan daftar informasi saldo.                                                                                                                    |
| [CurrencyService](./#currencyservice)         | `CurrencyService` mengelola operasi yang berkaitan dengan mata uang ZEPETO World. Layanan ini memungkinkan pemain memeriksa saldo mereka, baik untuk mata uang resmi ZEPETO (ZEM) maupun mata uang in-World. |
| [CurrencyError](./#currencyerror)             | Kode error yang menunjukkan penyebab kegagalan permintaan terkait mata uang.                                                                                                                                 |

## BalanceRecord

`class`

Informasi saldo untuk mata uang tertentu.

### Properti

| Nama       | Tipe     | Deskripsi                                                                         |
| ---------- | -------- | --------------------------------------------------------------------------------- |
| currencyId | `string` | ID mata uang in-World. Bernilai string kosong untuk mata uang resmi ZEPETO (ZEM). |
| quantity   | `bigint` | Saldo pemain untuk mata uang tersebut.                                            |

## BalanceResponse

`class` · extends `ProductBaseResponse`

Class `BalanceResponse` menyediakan hasil pemanggilan API dan informasi saldo.

### Properti

| Nama     | Tipe                              | Deskripsi        |
| -------- | --------------------------------- | ---------------- |
| currency | [BalanceRecord](./#balancerecord) | Informasi saldo. |

## BalanceListResponse

`class` · extends `ProductBaseResponse`

Class `BalanceListResponse` menyediakan hasil pemanggilan API dan daftar informasi saldo.

### Properti

| Nama       | Tipe                         | Deskripsi                                                                                   |
| ---------- | ---------------------------- | ------------------------------------------------------------------------------------------- |
| currencies | `Dictionary<string, bigint>` | Koleksi yang memetakan ID mata uang in-World ke saldo pemain untuk masing-masing mata uang. |

## CurrencyService

`class`

`CurrencyService` mengelola operasi yang berkaitan dengan mata uang ZEPETO World.
Layanan ini memungkinkan pemain memeriksa saldo mereka, baik untuk mata uang resmi ZEPETO (ZEM) maupun mata uang in-World.

### Metode

### GetUserCurrencyBalancesAsync

`static GetUserCurrencyBalancesAsync() → BaseRequest<BalanceListResponse>`

Metode asinkron ini mengambil informasi saldo untuk seluruh mata uang in-World yang telah didefinisikan.

**Mengembalikan:** `BaseRequest<BalanceListResponse>` — Objek `BaseRequest`. Setelah proses asinkron selesai, Anda dapat mengakses objek `BalanceListResponse` melalui properti `responseData`.

### GetUserCurrencyBalanceAsync

`static GetUserCurrencyBalanceAsync(currencyId: string) → BaseRequest<BalanceResponse>`

Metode asinkron ini mengambil saldo untuk mata uang in-World tertentu berdasarkan ID mata uang yang diberikan.

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

**Mengembalikan:** `BaseRequest<BalanceResponse>` — Objek `BaseRequest`. Setelah proses asinkron selesai, Anda dapat mengakses objek `BalanceResponse` melalui properti `responseData`.

### GetOfficialCurrencyBalanceAsync

`static GetOfficialCurrencyBalanceAsync() → OfficialCurrencyBalanceRequest`

Metode asinkron ini mengambil saldo mata uang resmi ZEPETO (ZEM).

**Mengembalikan:** `OfficialCurrencyBalanceRequest` — Objek `OfficialCurrencyBalanceRequest`. Setelah proses asinkron selesai, Anda dapat mengakses objek `BalanceResponse` melalui properti `responseData`.

## CurrencyError

`enum`

Kode error yang menunjukkan penyebab kegagalan permintaan terkait mata uang.

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