---
title: ZEPETO.Multiplay.Currency
slug: world-sdk-guide-th/zepetomultiplaycurrency
docTags: 
createdAt: 2026-09-04T06:13:10.656Z
---

| ประเภท                            | คำอธิบาย                                                                         |
| --------------------------------- | -------------------------------------------------------------------------------- |
| [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` ที่ resolve เมื่อดำเนินการเสร็จสิ้น โดยระบุความสำเร็จ (`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` ที่ resolve เมื่อดำเนินการเสร็จสิ้น โดยระบุความสำเร็จ (`true`) หรือความล้มเหลว (`false`)

### getBalance

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

ดึงยอดคงเหลือสกุลเงินภายใน World ของผู้เล่น โดยจะโยน `CurrencyError`

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

**ค่าที่คืนกลับ:** `Promise<number>` — `Promise` ที่ resolve เมื่อดำเนินการเสร็จสิ้น พร้อมจำนวนยอดคงเหลือที่ดึงมา

### getBalances

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

ดึงยอดคงเหลือของสกุลเงินภายใน World แต่ละสกุลที่ผู้เล่นมีอยู่ โดยจะโยน `CurrencyError`

**ค่าที่คืนกลับ:** `Promise<{ [key: string]: number }>` — `Promise` ที่ resolve เมื่อดำเนินการเสร็จสิ้น พร้อมอ็อบเจกต์ที่ใช้ ID ของสกุลเงินภายใน World แต่ละสกุลเป็นคีย์ และมียอดคงเหลือที่สอดคล้องกันเป็นค่า