> 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/cs/billing-api/wallet.md).
# Peněženka
## Přehled
API peněženky umožňuje inzerentům spravovat digitální peněženky používané pro rozpočet kampaní a kontrolu výdajů. Každá peněženka je propojena s jedinou měnou a týmem a podporuje funkce, jako jsou denní rozpočty a správa peněžních prostředků.
Inzerenti mohou spravovat více peněženek, z nichž každá má svůj vlastní úvěrový zůstatek a řízení výdajů. S těmito API můžete:
* Spravovat názvy peněženek
* Zobrazovat ID peněženek
* Přistupovat k kódům měn
* Nastavovat denní rozpočty
* Kontrolovat aktuální zůstatky
* Zobrazovat dostupné zůstatky
* Řídit stavy archivace
* Spravovat prostředky (pouze pro maloobchodníky) a další
### Základy peněženky
#### Účel
Peněženky jsou pro inzerenty nezbytnými nástroji pro správu, kontrolu a podávání zpráv o rozpočtech kampaní. Umožňují detailní sledování podle regionu, produktu nebo týmu a podporují rozpočtování a kontrolu výdajů v konkrétních měnách.
Předpokládejme, že váš marketingový tým potřebuje spustit kampaně pro tři regiony (US, EU, APAC), každý s vlastním rozpočtem a měnou. Vytvoříte tři peněženky:
* **US Wallet (USD)**: 20 000 $, denní limit 2 000 $.
* **EU Wallet (EUR)**: 15 000 €, denní limit 1 500 €.
* **APAC Wallet (AUD)**: 10 000 A$, denní limit 1 000 A$.
Každá kampaň je propojena s peněženkou svého regionu. Pokud v peněžence US docházejí prostředky, pozastaví se pouze kampaně pro US. EU a APAC pokračují bez ovlivnění. Můžete vykazovat výdaje, ROI a čerpání podle peněženky a váš finanční tým může každou peněženku vyúčtovat zvlášť.
{% hint style="info" %}
Inzerenti mohou peněženky používat pouze v katalozích maloobchodníků, kteří podporují stejnou měnu.
{% endhint %}
#### Více peněženek
Inzerenti mohou vytvořit více peněženek na základě svého provozního modelu. Každá kampaň může být v daný okamžik propojena pouze s jednou peněženkou, což zajišťuje jasné oddělení rozpočtu a sledování výdajů. Pokud si nepřejete vytvářet více peněženek, můžete libovolně používat výchozí peněženku.
#### Organizace rozpočtu napříč peněženkami
Peněženky pomáhají společnostem spravovat jejich rozpočty na reklamu tím, že organizují prostředky na základě měny a účelu. Velké organizace mohou například vytvořit samostatné peněženky pro různá oddělení nebo kampaně. Toto nastavení umožňuje každé skupině kontrolovat své vlastní denní výdaje, aniž by to ovlivnilo ostatní.
Každá peněženka udržuje úvěrový zůstatek ve své určené měně, což usnadňuje správu rozpočtů napříč více měnami. Inzerenti mohou vytvořit více peněženek, z nichž každá má svůj vlastní úvěrový zůstatek a unikátní ID peněženky. Toto ID se používá k identifikaci a správě jednotlivých peněženek.
{% hint style="info" %}
Ke spuštění kampaně potřebujete v peněžence dostatek peněžních prostředků. Jakmile peněženka dosáhne nastaveného rozpočtu, reklama se přestane zobrazovat.
{% endhint %}
Vzhledem k tomu, že každá kampaň může být propojena pouze s jednou peněženkou najednou, je efektivní správa zůstatků v peněžence zásadní pro nepřerušené doručování kampaní.
#### Kompatibilita měny s katalogy
Některé funkce peněženky, jako je vytváření nebo úprava peněženek, nemusí být dostupné všem inzerentům v závislosti na konfiguraci maloobchodníka. Pokud má maloobchodník omezení, zobrazí se vám příslušné chybové zprávy a určité funkce související s peněženkou mohou být v uživatelském rozhraní skryty.
Při vytváření kampaně a výběru katalogu je každý katalog spojen s konkrétní měnou. Musíte vybrat peněženku, která odpovídá měně katalogu. Pokud například váš katalog používá AUD (australský dolar), nemůžete vybrat peněženku v GBP (britská libra). Systém vám při vytváření kampaně zabrání ve výběru neodpovídající měny.
### Funkce peněženky
Peněženky vám pomáhají spravovat rozpočty a výdaje napříč kampaněmi, včetně:
* **Podpora více peněženek**: Umožňuje oddělení rozpočtu podle týmu, kampaně nebo oddělení.
* **Peněženky v konkrétní měně**: Pracují v jediné měně.
* **Archivované peněženky**: Uchovávají historii bez ovlivnění aktivních kampaní.
### Prvky peněženky
Každá peněženka obsahuje následující klíčové prvky:
| Název | Popis |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Název peněženky | Název přiřazený peněžence. |
| ID peněženky | Unikátní identifikátor používaný k účtování správné peněženky za kampaň. |
| Měna | Měna, ve které peněženka pracuje. |
| Aktuální zůstatek | Zůstatek peněženky bez započtení úvěrového limitu. |
| Dostupný zůstatek | Celková částka k utracení, včetně úvěrového limitu. |
| Úvěrový limit | Příspěvek na překročení výdajů, který se měsíčně resetuje.
Poznámka: Toto je zastaralá funkce a většina maloobchodníků ji nepodporuje.
|
| Stav archivace | Označuje, že peněženka již není aktivní, ale je zachována pro účely záznamů. |
Peněženky svého týmu si můžete zobrazit v sekci **Peněženky**. V závislosti na konfiguraci vašeho maloobchodníka můžete mít přístup k zobrazení nebo úpravě konkrétních nastavení peněženky.
#### Příklad
Společnost A plánuje rozdělit svůj rozpočet na reklamu mezi tři typy produktů: 10 000 $ pro Produkt A, 5 000 $ pro Produkt B a 1 200 $ pro Produkt C. Aby to společnost spravovala, vytvoří tři samostatné peněženky, jednu pro každý typ produktu s odpovídajícími částkami.
Při nastavování kampaní je každá kampaň propojena s peněženkou přiřazenou k jejímu příslušnému produktu. Toto nastavení umožňuje týmu nezávisle kontrolovat a sledovat výdaje na reklamu pro každý typ produktu a zajišťuje, že rozpočty budou použity tak, jak bylo zamýšleno.
#### Co je to External ID?
**External ID** je volitelné pole, do kterého můžete uložit vlastní referenční čísla, jako je nákupní objednávka, Salesforce ID nebo číslo Placement IO. Pomáhá partnerům sledovat a propojovat peněženku s jejich vlastními systémy.
> **Poznámka:** Toto pole je viditelné pouze v případě, že váš maloobchodník povoli příznak funkce (feature flag).
### Rozpočtový limit a čerpání
Abychom inzerentům pomohli efektivně spravovat jejich denní výdaje na reklamu, peněženky podporují následující ovládací prvky:
#### Denní limit / Denní výdaje
Maximální částka, kterou smí peněženka utratit za jediný den. Tento strop zajišťuje, že kampaně nepřekročí předem definovaný denní rozpočet.
#### Čerpání rozpočtu
Pokud v daný den není vyčerpán celý denní limit, nevyčerpaná částka se převádí do následujícího dne. To umožňuje flexibilní čerpání rozpočtu v průběhu více dní.
#### Zbývající denní limit
Část denního limitu, která zůstala nevyčerpána z předchozího dne. Tato částka se přičítá k dennímu limitu na následující den, což umožňuje flexibilitu kumulativního utrácení.
> **Poznámka:** Dostupnost denních rozpočtových limitů závisí na tom, zda maloobchodník povolil příznak funkce (feature flag).
### Dostupné koncové body
| Koncový bod | Popis |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| [Create wallet](/retail-media-interface/partner/cs/billing-api/wallet/createwallet.md) | Nastavte novou peněženku s jmenným prostorem, týmem, názvem, měnou, denním rozpočtem a volitelným externím ID. |
| [Update wallet](/retail-media-interface/partner/cs/billing-api/wallet/updatewallet-1.md) | Upravte název peněženky, měnu, denní rozpočet, úvěrový limit nebo externí ID. |
| [Retrieve wallet by ID](/retail-media-interface/partner/cs/billing-api/wallet/getwallet-1.md) | Načtěte podrobnosti o peněžence pomocí jejího jedinečného identifikátoru. |
| [List all wallets](/retail-media-interface/partner/cs/billing-api/wallet/listwallets.md) | Získejte seznam všech peněženek spojených s vaším týmem. |
| [Get balance of specific wallet](/retail-media-interface/partner/cs/billing-api/wallet/getwalletbalance.md) | Zkontrolujte aktuální a dostupné zůstatky pomocí jejího jedinečného identifikátoru. |
| [Manage funds to specific wallet](/retail-media-interface/partner/cs/billing-api/wallet/managefunds.md) | Přidejte prostředky do peněženky a zvyšte tak její dostupný zůstatek pro výdaje na kampaně. |
### Definice polí Wallet API
Níže jsou uvedena klíčová pole peněženky běžně používaná v požadavcích a odpovědích API:
| Pole | Popis |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| walletId | Jedinečný identifikátor peněženky. |
| currency | Kód měny (např. USD, EUR). |
| creditLimit | Měsíční povolené překročení výdajů.
Poznámka: Toto je zastaralá funkce a většina maloobchodníků ji nepodporuje.
|
| dailyBudget | Denní limit výdajů. |
| availableBalance | Částka k utracení včetně úvěru. |
| currentBalance | Skutečný zůstatek peněženky bez úvěru. |
| externalId | Volitelné pole pro čísla objednávek, ID Salesforce atd. |
| archived | Booleovský příznak označující, zda je peněženka archivována. |
Často kladené otázky a řešení problémů naleznete v části [Často kladené otázky](/retail-media-interface/partner/cs/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/cs/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.