---
title: ZEPETO.Multiplay.Currency
slug: world-sdk-guide-fr/zepetomultiplaycurrency
docTags: 
createdAt: 2026-09-04T06:06:18.161Z
---

| Type                              | Description                                                                           |
| --------------------------------- | ------------------------------------------------------------------------------------- |
| [CurrencyError](./#currencyerror) | Code d'erreur indiquant la raison de l'échec des requêtes liées aux devises in-World. |
| [Currency](./#currency)           | `Currency` gère les opérations liées aux devises du ZEPETO World.                     |

## CurrencyError

`enum`

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

| 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. |

## Currency

`interface`

`Currency` gère les opérations liées aux devises du ZEPETO World.

### Méthodes

### debit

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

Déduit le montant spécifié du solde de devise in-World du joueur. Lève `CurrencyError`.

| Paramètre             | Type     | Description                                                 |
| --------------------- | -------- | ----------------------------------------------------------- |
| id                    | `string` | ID de la devise à déduire.                                  |
| quantity (facultatif) | `number` | Quantité de devise à déduire. La valeur par défaut est `1`. |
| reason (facultatif)   | `string` | Décrit éventuellement la raison de la déduction.            |

**Renvoie :** `Promise<boolean>` — `Promise` résolue à la fin de l'opération, indiquant la réussite (`true`) ou l'échec (`false`).

### credit

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

Augmente le solde de devise in-World du joueur du montant spécifié. Lève `CurrencyError`.

| Paramètre             | Type     | Description                                                   |
| --------------------- | -------- | ------------------------------------------------------------- |
| id                    | `string` | ID de la devise à augmenter.                                  |
| quantity (facultatif) | `number` | Quantité de devise à augmenter. La valeur par défaut est `1`. |
| reason (facultatif)   | `string` | Décrit éventuellement la raison de l'augmentation.            |

**Renvoie :** `Promise<boolean>` — `Promise` résolue à la fin de l'opération, indiquant la réussite (`true`) ou l'échec (`false`).

### getBalance

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

Récupère le solde de la devise in-World du joueur. Lève `CurrencyError`.

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

**Renvoie :** `Promise<number>` — `Promise` résolue à la fin de l'opération, avec le montant du solde récupéré.

### getBalances

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

Récupère le solde de chaque devise in-World que possède le joueur. Lève `CurrencyError`.

**Renvoie :** `Promise<{ [key: string]: number }>` — `Promise` résolue à la fin de l'opération, avec un objet dont chaque clé est un ID de devise in-World et dont la valeur associée est le solde correspondant.