---
title: ZEPETO.Currency
slug: world-sdk-guide-th/zepetocurrency
docTags: 
createdAt: 2026-09-04T05:54:59.644Z
---

| ประเภท                                        | คำอธิบาย                                                                                                                                                                          |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [BalanceRecord](./#balancerecord)             | ข้อมูลยอดคงเหลือของสกุลเงินที่ระบุ                                                                                                                                                |
| [BalanceResponse](./#balanceresponse)         | คลาส `BalanceResponse` ให้ผลลัพธ์การเรียก API และข้อมูลยอดคงเหลือ                                                                                                                 |
| [BalanceListResponse](./#balancelistresponse) | คลาส `BalanceListResponse` ให้ผลลัพธ์การเรียก API และรายการข้อมูลยอดคงเหลือ                                                                                                       |
| [CurrencyService](./#currencyservice)         | `CurrencyService` จัดการการดำเนินการที่เกี่ยวข้องกับสกุลเงินของ ZEPETO World บริการนี้ช่วยให้ผู้เล่นตรวจสอบยอดคงเหลือได้ทั้งสกุลเงินทางการของ ZEPETO (ZEM) และสกุลเงินภายใน World |
| [CurrencyError](./#currencyerror)             | รหัสข้อผิดพลาดที่ระบุสาเหตุความล้มเหลวของคำขอที่เกี่ยวข้องกับสกุลเงิน                                                                                                             |

## BalanceRecord

`class`

ข้อมูลยอดคงเหลือของสกุลเงินที่ระบุ

### พร็อพเพอร์ตี้

| ชื่อ       | ประเภท   | คำอธิบาย                                                                         |
| ---------- | -------- | -------------------------------------------------------------------------------- |
| currencyId | `string` | ID ของสกุลเงินภายใน World โดยจะเป็นสตริงว่างสำหรับสกุลเงินทางการของ ZEPETO (ZEM) |
| quantity   | `bigint` | ยอดคงเหลือของผู้เล่นสำหรับสกุลเงินนั้น                                           |

## BalanceResponse

`class` · extends `ProductBaseResponse`

คลาส `BalanceResponse` ให้ผลลัพธ์การเรียก API และข้อมูลยอดคงเหลือ

### พร็อพเพอร์ตี้

| ชื่อ     | ประเภท                            | คำอธิบาย         |
| -------- | --------------------------------- | ---------------- |
| currency | [BalanceRecord](./#balancerecord) | ข้อมูลยอดคงเหลือ |

## BalanceListResponse

`class` · extends `ProductBaseResponse`

คลาส `BalanceListResponse` ให้ผลลัพธ์การเรียก API และรายการข้อมูลยอดคงเหลือ

### พร็อพเพอร์ตี้

| ชื่อ       | ประเภท                       | คำอธิบาย                                                                            |
| ---------- | ---------------------------- | ----------------------------------------------------------------------------------- |
| currencies | `Dictionary<string, bigint>` | คอลเลกชันที่จับคู่ ID ของสกุลเงินภายใน World กับยอดคงเหลือของผู้เล่นในแต่ละสกุลเงิน |

## CurrencyService

`class`

`CurrencyService` จัดการการดำเนินการที่เกี่ยวข้องกับสกุลเงินของ ZEPETO World
บริการนี้ช่วยให้ผู้เล่นตรวจสอบยอดคงเหลือได้ทั้งสกุลเงินทางการของ ZEPETO (ZEM) และสกุลเงินภายใน World

### เมธอด

### GetUserCurrencyBalancesAsync

`static GetUserCurrencyBalancesAsync() → BaseRequest<BalanceListResponse>`

เมธอดแบบอะซิงโครนัสนี้ใช้ดึงข้อมูลยอดคงเหลือของสกุลเงินภายใน World ทุกสกุลที่กำหนดไว้

**ค่าที่คืนกลับ:** `BaseRequest<BalanceListResponse>` — อ็อบเจกต์ `BaseRequest` เมื่อกระบวนการแบบอะซิงโครนัสเสร็จสิ้น คุณจะสามารถเข้าถึงอ็อบเจกต์ `BalanceListResponse` ได้ผ่านพร็อพเพอร์ตี้ `responseData`

### GetUserCurrencyBalanceAsync

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

เมธอดแบบอะซิงโครนัสนี้ใช้ดึงยอดคงเหลือของสกุลเงินภายใน World ที่ระบุ ตาม ID สกุลเงินที่ให้มา

| พารามิเตอร์ | ประเภท   | คำอธิบาย               |
| ----------- | -------- | ---------------------- |
| currencyId  | `string` | ID ของสกุลเงินที่จะดึง |

**ค่าที่คืนกลับ:** `BaseRequest<BalanceResponse>` — อ็อบเจกต์ `BaseRequest` เมื่อกระบวนการแบบอะซิงโครนัสเสร็จสิ้น คุณจะสามารถเข้าถึงอ็อบเจกต์ `BalanceResponse` ได้ผ่านพร็อพเพอร์ตี้ `responseData`

### GetOfficialCurrencyBalanceAsync

`static GetOfficialCurrencyBalanceAsync() → OfficialCurrencyBalanceRequest`

เมธอดแบบอะซิงโครนัสนี้ใช้ดึงยอดคงเหลือของสกุลเงินทางการของ ZEPETO (ZEM)

**ค่าที่คืนกลับ:** `OfficialCurrencyBalanceRequest` — อ็อบเจกต์ `OfficialCurrencyBalanceRequest` เมื่อกระบวนการแบบอะซิงโครนัสเสร็จสิ้น คุณจะสามารถเข้าถึงอ็อบเจกต์ `BalanceResponse` ได้ผ่านพร็อพเพอร์ตี้ `responseData`

## CurrencyError

`enum`

รหัสข้อผิดพลาดที่ระบุสาเหตุความล้มเหลวของคำขอที่เกี่ยวข้องกับสกุลเงิน

| ชื่อ         | ค่า | คำอธิบาย                                                                                                   |
| ------------ | --- | ---------------------------------------------------------------------------------------------------------- |
| Unknown      | -1  | ข้อผิดพลาด: ข้อผิดพลาดที่ไม่ทราบสาเหตุ                                                                     |
| NetworkError | 0   | ข้อผิดพลาด: ข้อผิดพลาดที่เกี่ยวข้องกับปัญหาเครือข่าย รวมถึงการหลุดการเชื่อมต่อหรือการเชื่อมต่อที่ไม่เสถียร |