> 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/de/billing-api/wallet.md).
# Wallet
## Überblick
Die Wallet-API ermöglicht es Werbetreibenden, digitale Wallets zu verwalten, die für die Kampagnenbudgetierung und Ausgabenkontrolle verwendet werden. Jedes Wallet ist an eine einzelne Währung und ein Team gebunden und unterstützt Funktionen wie Tagesbudgets und Guthabenverwaltung.
Werbetreibende können mehrere Wallets verwalten, jedes mit eigenem Guthaben und eigenen Ausgabenkontrollen. Mit diesen APIs können Sie:
* Wallet-Namen verwalten
* Wallet-IDs anzeigen
* Auf Währungscodes zugreifen
* Tagesbudgets festlegen
* Aktuelle Kontostände prüfen
* Verfügbare Guthaben anzeigen
* Archivierungszustände steuern
* Guthaben verwalten (nur Händler) und mehr
### Wallet-Grundlagen
#### Zweck
Wallets sind essenzielle Werkzeuge für Werbetreibende, um Kampagnenbudgets zu verwalten, zu steuern und darüber Bericht zu erstatten. Sie ermöglichen eine detaillierte Nachverfolgung nach Region, Produkt oder Team und unterstützen währungsspezifische Budgetierung und Ausgabenkontrolle.
Angenommen, Ihr Marketingteam muss Kampagnen für drei Regionen (US, EU, APAC) durchführen, jede mit eigenem Budget und eigener Währung. Sie erstellen drei Wallets:
* **US-Wallet (USD)**: 20.000 $, Tageslimit 2.000 $.
* **EU-Wallet (EUR)**: 15.000 €, Tageslimit 1.500 €.
* **APAC-Wallet (AUD)**: 10.000 A$, Tageslimit 1.000 A$.
Jede Kampagne ist mit dem Wallet ihrer Region verknüpft. Wenn das US-Wallet zur Neige geht, pausieren nur die US-Kampagnen. EU und APAC laufen unbeeinflusst weiter. Sie können Ausgaben, ROI und Pacing pro Wallet auswerten, und Ihr Finanzteam kann jedes Wallet separat abstimmen.
{% hint style="info" %}
Werbetreibende können Wallets nur für Händlerkataloge nutzen, die dieselbe Währung unterstützen.
{% endhint %}
#### Mehrere Wallets
Werbetreibende können basierend auf ihrem Betriebsmodell mehrere Wallets erstellen. Jede Kampagne kann jeweils nur mit einem Wallet verknüpft werden, was eine klare Budgettrennung und Ausgabenverfolgung gewährleistet. Es steht Ihnen frei, das Standard-Wallet zu verwenden, wenn Sie keine mehreren Wallets erstellen möchten.
#### Budgetorganisation über Wallets hinweg
Wallets helfen Unternehmen bei der Verwaltung ihrer Werbebudgets, indem sie Gelder nach Währung und Zweck organisieren. Beispielsweise können große Organisationen separate Wallets für verschiedene Abteilungen oder Kampagnen erstellen. Diese Einrichtung ermöglicht es jeder Gruppe, ihre eigenen täglichen Ausgaben zu steuern, ohne andere zu beeinträchtigen.
Jedes Wallet verwaltet ein Guthaben in seiner festgelegten Währung, was die Verwaltung von Budgets über mehrere Währungen hinweg erleichtert. Werbetreibende können mehrere Wallets erstellen, jedes mit eigenem Guthaben und eindeutiger Wallet-ID. Diese ID wird verwendet, um Wallets individuell zu identifizieren und zu verwalten.
{% hint style="info" %}
Sie benötigen ausreichend Guthaben in Ihrem Wallet, um eine Kampagne auszuführen. Sobald das Wallet sein festgelegtes Budget erreicht hat, wird die Ausspielung der Anzeige gestoppt.
{% endhint %}
Da jede Kampagne jeweils nur mit einem Wallet verknüpft werden kann, ist eine effektive Verwaltung der Wallet-Guthaben entscheidend für eine unterbrechungsfreie Kampagnenauslieferung.
#### Währungskompatibilität mit Katalogen
Einige Wallet-Funktionen wie das Erstellen oder Bearbeiten von Wallets sind je nach Konfiguration des Händlers möglicherweise nicht für alle Werbetreibenden verfügbar. Wenn ein Händler Einschränkungen hat, werden relevante Fehlermeldungen angezeigt, und bestimmte wallet-bezogene Funktionen sind in der Benutzeroberfläche möglicherweise ausgeblendet.
Beim Erstellen einer Kampagne und Auswählen eines Katalogs ist jeder Katalog mit einer bestimmten Währung verknüpft. Sie müssen ein Wallet wählen, das zur Währung des Katalogs passt. Wenn Ihr Katalog beispielsweise AUD (Australischer Dollar) verwendet, können Sie kein Wallet in GBP (Britisches Pfund) auswählen. Das System verhindert, dass Sie während der Kampagnenerstellung eine nicht passende Währung auswählen.
### Wallet-Funktionen
Wallets helfen Ihnen bei der Verwaltung von Budgets und Ausgaben über Kampagnen hinweg, einschließlich:
* **Unterstützung mehrerer Wallets**: Ermöglicht die Budgettrennung nach Team, Kampagne oder Abteilung.
* **Währungsspezifische Wallets**: Arbeiten in einer einzigen Währung.
* **Archivierte Wallets**: Bewahren den Verlauf auf, ohne aktive Kampagnen zu beeinträchtigen.
### Wallet-Elemente
Jedes Wallet enthält die folgenden Schlüsselelemente:
| Name | Beschreibung |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Wallet-Name | Der dem Wallet zugewiesene Name. |
| Wallet-ID | Eine eindeutige Kennung, mit der das richtige Wallet für eine Kampagne belastet wird. |
| Währung | Die Währung, in der das Wallet geführt wird. |
| Aktuelles Guthaben | Das Guthaben des Wallets ohne Kreditlimit. |
| Verfügbares Guthaben | Der gesamte verbleibende Betrag, der ausgegeben werden kann, einschließlich des Kreditlimits. |
| Kreditlimit | Ein Überziehungsrahmen, der monatlich zurückgesetzt wird.
Hinweis: Dies ist eine veraltete Funktion, die von den meisten Händlern nicht unterstützt wird.
|
| Archivierter Zustand | Gibt an, dass das Wallet nicht mehr aktiv ist, aber für die Dokumentation aufbewahrt wird. |
Sie können die Wallets Ihres Teams im Bereich **Wallets** einsehen. Je nach Konfiguration Ihres Händlers haben Sie möglicherweise Zugriff zum Anzeigen oder Ändern bestimmter Wallet-Einstellungen.
#### Beispiel
Unternehmen A plant, sein Werbebudget auf drei Produkttypen aufzuteilen: 10.000 $ für Produkt A, 5.000 $ für Produkt B und 1.200 $ für Produkt C. Um dies zu verwalten, erstellt das Unternehmen drei separate Wallets, eines für jeden Produkttyp mit den entsprechenden Beträgen.
Beim Einrichten von Kampagnen wird jede Kampagne mit dem Wallet verknüpft, das ihrem jeweiligen Produkt zugewiesen ist. Diese Einrichtung ermöglicht es dem Team, die Werbeausgaben für jeden Produkttyp unabhängig zu steuern und zu überwachen, um sicherzustellen, dass die Budgets wie vorgesehen verwendet werden.
#### Was ist eine externe ID?
Eine **externe ID** ist ein optionales Feld, in dem Sie benutzerdefinierte Referenznummern wie eine Bestellnummer, eine Salesforce-ID oder eine Placement IO-Nummer speichern können. Sie hilft Partnern dabei, das Wallet nachzuverfolgen und mit ihren eigenen Systemen zu verknüpfen.
> **Hinweis:** Dieses Feld ist nur sichtbar, wenn Ihr Händler das Feature-Flag aktiviert hat.
### Budgetlimit und Pacing
Um Werbetreibenden dabei zu helfen, ihre täglichen Werbeausgaben effektiv zu steuern, unterstützen Wallets die folgenden Kontrollen:
#### Tageslimit / Tägliche Ausgaben
Der maximale Betrag, den ein Wallet an einem einzelnen Tag ausgeben darf. Diese Obergrenze stellt sicher, dass Kampagnen ein vordefiniertes Tagesbudget nicht überschreiten.
#### Budget-Pacing
Wenn das gesamte Tageslimit an einem bestimmten Tag nicht ausgeschöpft wird, wird der nicht genutzte Betrag auf den nächsten Tag übertragen. Dies ermöglicht ein flexibles Pacing des Budgets über mehrere Tage hinweg.
#### Verbleibendes Tageslimit
Der Teil des Tageslimits, der vom Vortag nicht ausgegeben wurde. Dieser Betrag wird zum Tageslimit des nächsten Tages hinzugefügt, was eine kumulative Ausgabenflexibilität ermöglicht.
> **Hinweis:** Die Verfügbarkeit von Tagesbudgetlimits setzt voraus, dass der Händler das Feature-Flag aktiviert hat.
### Verfügbare Endpunkte
| Endpunkt | Beschreibung |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| [Geldbörse erstellen](/retail-media-interface/partner/de/billing-api/wallet/createwallet.md) | Richten Sie ein neues Wallet mit einem Namespace, Team, Namen, einer Währung, einem Tagesbudget und einer optionalen externen ID ein. |
| [Geldbörse aktualisieren](/retail-media-interface/partner/de/billing-api/wallet/updatewallet-1.md) | Bearbeiten Sie Wallet-Name, Währung, Tagesbudget, Kreditlimit oder externe ID. |
| [Geldbörse nach ID abrufen](/retail-media-interface/partner/de/billing-api/wallet/getwallet-1.md) | Rufen Sie Wallet-Details über die eindeutige Kennung ab. |
| [Alle Geldbörsen auflisten](/retail-media-interface/partner/de/billing-api/wallet/listwallets.md) | Rufen Sie eine Liste aller mit Ihrem Team verknüpften Wallets ab. |
| [Guthaben einer bestimmten Geldbörse abrufen](/retail-media-interface/partner/de/billing-api/wallet/getwalletbalance.md) | Überprüfen Sie den aktuellen und verfügbaren Kontostand mithilfe der eindeutigen Kennung. |
| [Guthaben für eine bestimmte Geldbörse verwalten](/retail-media-interface/partner/de/billing-api/wallet/managefunds.md) | Fügen Sie einem Wallet Guthaben hinzu, um das verfügbare Guthaben für Kampagnenausgaben zu erhöhen. |
### Felddefinitionen der Wallet-API
Im Folgenden finden Sie wichtige Wallet-Felder, die häufig in API-Anfragen und -Antworten verwendet werden:
| Feld | Beschreibung |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId | Eindeutige Kennung für das Wallet. |
| currency | Währungscode (z. B. USD, EUR). |
| creditLimit | Monatlicher Rahmen für Überzieher.
Hinweis: Dies ist eine veraltete Funktion, die von den meisten Händlern nicht unterstützt wird.
|
| dailyBudget | Obergrenze für tägliche Ausgaben. |
| availableBalance | Verfügbarer Betrag einschließlich Kredit. |
| currentBalance | Tatsächliches Wallet-Guthaben ohne Kredit. |
| externalId | Optionales Feld für Bestellnummern, Salesforce-IDs usw. |
| archived | Boolean-Flag, das angibt, ob das Wallet archiviert ist. |
Für häufig gestellte Fragen und Fehlerbehebung siehe [Häufig gestellte Fragen](/retail-media-interface/partner/de/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/de/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.