> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/fr/billing-api/wallet.md).
# Portefeuille
## Aperçu
L'API wallet permet aux annonceurs de gérer les portefeuilles numériques utilisés pour la budgétisation des campagnes et le contrôle des dépenses. Chaque portefeuille est lié à une seule devise et équipe, et prend en charge des fonctionnalités telles que les budgets quotidiens et la gestion des fonds.
Les annonceurs peuvent maintenir plusieurs portefeuilles, chacun avec son propre solde de crédit et ses contrôles de dépenses. Avec ces API, vous pouvez :
* Gérer les noms de portefeuilles
* Afficher les ID de portefeuilles
* Accéder aux codes de devise
* Définir des budgets quotidiens
* Vérifier les soldes actuels
* Afficher les soldes disponibles
* Contrôler les états d'archivage
* Gérer les fonds (détaillants uniquement), et plus encore
### Principes fondamentaux du portefeuille
#### Objectif
Les portefeuilles sont des outils essentiels permettant aux annonceurs de gérer, contrôler et suivre les budgets de campagne. Ils permettent un suivi précis par région, produit ou équipe, et prennent en charge la budgétisation et le contrôle des dépenses spécifiques à chaque devise.
Supposons que votre équipe marketing doive exécuter des campagnes pour trois régions (US, EU, APAC), chacune avec son propre budget et sa propre devise. Vous créez trois portefeuilles :
* **US Wallet (USD)** : 20 000 $, limite quotidienne 2 000 $.
* **EU Wallet (EUR)** : 15 000 €, limite quotidienne 1 500 €.
* **APAC Wallet (AUD)** : 10 000 A$, limite quotidienne 1 000 A$.
Chaque campagne est liée au portefeuille de sa région. Si le portefeuille US s'épuise, seules les campagnes US se mettent en pause. L'UE et l'APAC continuent sans être affectées. Vous pouvez effectuer des rapports sur les dépenses, le ROI et le rythme de diffusion par portefeuille, et votre équipe financière peut rapprocher chaque portefeuille séparément.
{% hint style="info" %}
Les annonceurs ne peuvent utiliser des portefeuilles que sur des catalogues de détaillants qui prennent en charge la même devise.
{% endhint %}
#### Portefeuilles multiples
Les annonceurs peuvent créer plusieurs portefeuilles en fonction de leur modèle d'exploitation. Chaque campagne ne peut être liée qu'à un seul portefeuille à la fois, garantissant une séparation claire des budgets et un suivi des dépenses. Vous êtes libre d'utiliser le portefeuille par défaut si vous ne souhaitez pas créer plusieurs portefeuilles.
#### Organisation du budget entre les portefeuilles
Les portefeuilles aident les entreprises à gérer leurs budgets publicitaires en organisant les fonds en fonction de la devise et de l'objectif. Par exemple, les grandes organisations peuvent créer des portefeuilles distincts pour différents départements ou campagnes. Cette configuration permet à chaque groupe de contrôler ses propres dépenses quotidiennes sans impacter les autres.
Chaque portefeuille conserve un solde de crédit dans sa devise désignée, ce qui facilite la gestion des budgets dans plusieurs devises. Les annonceurs peuvent créer plusieurs portefeuilles, chacun avec son propre solde de crédit et son ID de portefeuille unique. Cet ID est utilisé pour identifier et gérer les portefeuilles individuellement.
{% hint style="info" %}
Vous devez disposer de fonds suffisants dans votre portefeuille pour exécuter une campagne. Une fois que le portefeuille atteint son budget défini, la publicité cesse de diffuser.
{% endhint %}
Puisque chaque campagne ne peut être liée qu'à un seul portefeuille à la fois, la gestion efficace des soldes de portefeuille est cruciale pour une diffusion ininterrompue de la campagne.
#### Compatibilité des devises avec les catalogues
Certaines fonctionnalités de portefeuille telles que la création ou la modification de portefeuilles peuvent ne pas être disponibles pour tous les annonceurs, selon la configuration du détaillant. Si un détaillant applique des restrictions, vous verrez des messages d'erreur pertinents et certaines fonctions liées au portefeuille peuvent être masquées dans l'interface utilisateur.
Lors de la création d'une campagne et de la sélection d'un catalogue, chaque catalogue est associé à une devise spécifique. Vous devez choisir un portefeuille qui correspond à la devise du catalogue. Par exemple, si votre catalogue utilise AUD (dollar australien), vous ne pouvez pas sélectionner un portefeuille en GBP (livre sterling). Le système vous empêchera de sélectionner une devise non correspondante lors de la création de la campagne.
### Fonctionnalités des portefeuilles
Les portefeuilles vous aident à gérer les budgets et les dépenses sur l'ensemble des campagnes, notamment :
* **Prise en charge multi-portefeuilles** : permet la séparation des budgets par équipe, campagne ou département.
* **Portefeuilles par devise spécifique** : fonctionne dans une seule devise.
* **Portefeuilles archivés** : conserve l'historique sans affecter les campagnes actives.
### Éléments du portefeuille
Chaque portefeuille comprend les éléments clés suivants :
| Nom | Description |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nom du portefeuille | Le nom attribué au portefeuille. |
| ID de portefeuille | Un identifiant unique utilisé pour débiter le bon portefeuille pour une campagne. |
| Devise | La devise dans laquelle le portefeuille fonctionne. |
| Solde actuel | Le solde du portefeuille hors limite de crédit. |
| Solde disponible | Le montant total dépensable, y compris la limite de crédit. |
| Limite de crédit | Une autorisation de dépassement de budget qui se réinitialise mensuellement.
Remarque : Il s'agit d'une fonctionnalité héritée qui n'est pas prise en charge par la plupart des détaillants.
|
| État archivé | Indique que le portefeuille n'est plus actif mais conservé pour les archives. |
Vous pouvez consulter les portefeuilles de votre équipe dans la section **Wallets**. Selon la configuration de votre détaillant, vous pouvez avoir accès à la consultation ou à la modification de paramètres de portefeuille spécifiques.
#### Exemple
L'entreprise A prévoit d'allouer son budget publicitaire sur trois types de produits : 10 000 $ pour le produit A, 5 000 $ pour le produit B et 1 200 $ pour le produit C. Pour gérer cela, l'entreprise crée trois portefeuilles distincts, un pour chaque type de produit avec les montants correspondants.
Lors de la configuration des campagnes, chaque campagne est liée au portefeuille attribué à son produit respectif. Cette configuration permet à l'équipe de contrôler et de surveiller les dépenses publicitaires pour chaque type de produit de manière indépendante, en veillant à ce que les budgets soient utilisés comme prévu.
#### Qu'est-ce qu'un ID externe ?
Un **ID externe** est un champ facultatif dans lequel vous pouvez stocker des numéros de référence personnalisés tels qu'un bon de commande, un ID Salesforce ou un numéro Placement IO. Il aide les partenaires à suivre et à lier le portefeuille à leurs propres systèmes.
> **Remarque :** Ce champ n'est visible que si votre détaillant a activé le flag de fonctionnalité.
### Limite de budget et rythme de diffusion
Pour aider les annonceurs à gérer efficacement leurs dépenses publicitaires quotidiennes, les portefeuilles prennent en charge les contrôles suivants :
#### Limite quotidienne / Dépense quotidienne
Le montant maximal qu'un portefeuille est autorisé à dépenser en une seule journée. Ce plafond garantit que les campagnes ne dépassent pas un budget quotidien prédéfini.
#### Rythme de diffusion du budget
Si la totalité de la limite quotidienne n'est pas dépensée un jour donné, le montant non dépensé est reporté au lendemain. Cela permet un rythme de diffusion flexible du budget sur plusieurs jours.
#### Limite quotidienne restante
La portion de la limite quotidienne qui reste non dépensée de la veille. Ce montant est ajouté à la limite quotidienne du lendemain, permettant une flexibilité de dépense cumulative.
> **Remarque :** La disponibilité des limites de budget quotidien est soumise à l'activation du flag de fonctionnalité par le détaillant.
### Points de terminaison disponibles
| Point de terminaison | Description |
| -------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Créer un portefeuille](/retail-media-interface/partner/fr/billing-api/wallet/createwallet.md) | Configurez un nouveau portefeuille avec un espace de noms, une équipe, un nom, une devise, un budget quotidien et un identifiant externe facultatif. |
| [Mettre à jour le portefeuille](/retail-media-interface/partner/fr/billing-api/wallet/updatewallet-1.md) | Modifiez le nom, la devise, le budget quotidien, la limite de crédit ou l'identifiant externe du portefeuille. |
| [Récupérer le portefeuille par son ID](/retail-media-interface/partner/fr/billing-api/wallet/getwallet-1.md) | Récupérez les détails d'un portefeuille à l'aide de son identifiant unique. |
| [Lister tous les portefeuilles](/retail-media-interface/partner/fr/billing-api/wallet/listwallets.md) | Obtenez une liste de tous les portefeuilles associés à votre équipe. |
| [Obtenir le solde d'un portefeuille spécifique](/retail-media-interface/partner/fr/billing-api/wallet/getwalletbalance.md) | Vérifiez les soldes actuels et disponibles, à l'aide de son identifiant unique. |
| [Gérer les fonds d'un portefeuille spécifique](/retail-media-interface/partner/fr/billing-api/wallet/managefunds.md) | Ajoutez des fonds à un portefeuille pour augmenter son solde disponible pour les dépenses de campagne. |
### Définitions des champs de l'API Wallet
Voici les principaux champs de portefeuille couramment utilisés dans les requêtes et réponses de l'API :
| Champ | Description |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| walletId | Identifiant unique pour le portefeuille. |
| currency | Code devise (ex. USD, EUR). |
| creditLimit | Marge de dépassement mensuelle autorisée.
Remarque : Il s'agit d'une fonctionnalité héritée qui n'est pas prise en charge par la plupart des détaillants.
|
| dailyBudget | Plafond de dépense quotidien. |
| availableBalance | Montant dépensable incluant le crédit. |
| currentBalance | Solde réel du portefeuille hors crédit. |
| externalId | Champ facultatif pour les numéros de bon de commande, les identifiants Salesforce, etc. |
| archived | Indicateur booléen indiquant si le portefeuille est archivé. |
Pour les questions fréquentes et le dépannage, voir [Foire aux questions](/retail-media-interface/partner/fr/partner-api-overview/frequently-asked-questions.md#wallet).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/partner/fr/billing-api/wallet.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.