---
title: ZEPETO.Currency
slug: world-sdk-guide-fr/zepetocurrency
docTags: 
createdAt: 2026-09-04T05:52:43.741Z
---

| Type                                          | Description                                                                                                                                                                                                         |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [BalanceRecord](./#balancerecord)             | Informations de solde pour une devise donnée.                                                                                                                                                                       |
| [BalanceResponse](./#balanceresponse)         | La classe `BalanceResponse` fournit le résultat de l'appel d'API ainsi que les informations de solde.                                                                                                               |
| [BalanceListResponse](./#balancelistresponse) | La classe `BalanceListResponse` fournit le résultat de l'appel d'API ainsi que la liste des informations de solde.                                                                                                  |
| [CurrencyService](./#currencyservice)         | `CurrencyService` gère les opérations liées aux devises du ZEPETO World. Ce service permet aux joueurs de consulter leur solde, aussi bien pour la devise officielle de ZEPETO (ZEM) que pour les devises in-World. |
| [CurrencyError](./#currencyerror)             | Code d'erreur indiquant la raison de l'échec des requêtes liées aux devises.                                                                                                                                        |

## BalanceRecord

`class`

Informations de solde pour une devise donnée.

### Propriétés

| Nom        | Type     | Description                                                                               |
| ---------- | -------- | ----------------------------------------------------------------------------------------- |
| currencyId | `string` | ID de la devise in-World. Vaut une chaîne vide pour la devise officielle de ZEPETO (ZEM). |
| quantity   | `bigint` | Solde du joueur pour cette devise.                                                        |

## BalanceResponse

`class` · extends `ProductBaseResponse`

La classe `BalanceResponse` fournit le résultat de l'appel d'API ainsi que les informations de solde.

### Propriétés

| Nom      | Type                              | Description            |
| -------- | --------------------------------- | ---------------------- |
| currency | [BalanceRecord](./#balancerecord) | Informations de solde. |

## BalanceListResponse

`class` · extends `ProductBaseResponse`

La classe `BalanceListResponse` fournit le résultat de l'appel d'API ainsi que la liste des informations de solde.

### Propriétés

| Nom        | Type                         | Description                                                                              |
| ---------- | ---------------------------- | ---------------------------------------------------------------------------------------- |
| currencies | `Dictionary<string, bigint>` | Collection associant les ID de devises in-World au solde du joueur pour chacune d'elles. |

## CurrencyService

`class`

`CurrencyService` gère les opérations liées aux devises du ZEPETO World.
Ce service permet aux joueurs de consulter leur solde, aussi bien pour la devise officielle de ZEPETO (ZEM) que pour les devises in-World.

### Méthodes

### GetUserCurrencyBalancesAsync

`static GetUserCurrencyBalancesAsync() → BaseRequest<BalanceListResponse>`

Cette méthode asynchrone récupère les informations de solde de toutes les devises in-World définies.

**Renvoie :** `BaseRequest<BalanceListResponse>` — Un objet `BaseRequest`. Une fois le traitement asynchrone terminé, vous pouvez accéder à l'objet `BalanceListResponse` via la propriété `responseData`.

### GetUserCurrencyBalanceAsync

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

Cette méthode asynchrone récupère le solde d'une devise in-World donnée à partir de l'ID de devise fourni.

| Paramètre  | Type     | Description                 |
| ---------- | -------- | --------------------------- |
| currencyId | `string` | ID de la devise à récupérer |

**Renvoie :** `BaseRequest<BalanceResponse>` — Un objet `BaseRequest`. Une fois le traitement asynchrone terminé, vous pouvez accéder à l'objet `BalanceResponse` via la propriété `responseData`.

### GetOfficialCurrencyBalanceAsync

`static GetOfficialCurrencyBalanceAsync() → OfficialCurrencyBalanceRequest`

Cette méthode asynchrone récupère le solde de la devise officielle de ZEPETO (ZEM).

**Renvoie :** `OfficialCurrencyBalanceRequest` — Un objet `OfficialCurrencyBalanceRequest`. Une fois le traitement asynchrone terminé, vous pouvez accéder à l'objet `BalanceResponse` via la propriété `responseData`.

## CurrencyError

`enum`

Code d'erreur indiquant la raison de l'échec des requêtes liées aux devises.

| Nom          | Valeur | Description                                                                               |
| ------------ | ------ | ----------------------------------------------------------------------------------------- |
| Unknown      | -1     | Erreur : erreur inconnue.                                                                 |
| NetworkError | 0      | Erreur : erreurs liées au réseau, notamment les déconnexions ou les connexions instables. |