> 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/sk/billing-api/wallet.md).

# Peňaženka

## Prehľad

Wallet API umožňuje inzerentom spravovať digitálne peňaženky používané na rozpočtovanie kampaňou a kontrolu výdavkov. Každá peňaženka je prepojená s jedinou menou a tímom a podporuje funkcie ako denné rozpočty a správa prostriedkov.

Inzerenti môžu spravovať viacero peňaženiek, z ktorých každá má svoj vlastný úverový zostatok a kontroly výdavkov. S týmito API môžete:

* Spravovať názvy peňaženiek
* Zobraziť ID peňaženiek
* Pristupovať k kódom mien
* Nastaviť denné rozpočty
* Kontrolovať aktuálne zostatky
* Zobraziť dostupné zostatky
* Riadiť stavy archivácie
* Spravovať prostriedky (iba maloobchodníci) a ďalšie

### Základy peňaženky

#### Účel

Peňaženky sú nevyhnutné nástroje pre inzerentov na spravovanie, kontrolu a vykazovanie rozpočtov kampaňou. Umožňujú detailné sledovanie podľa regiónu, produktu alebo tímu a podporujú rozpočtovanie a kontrolu výdavkov špecifickú pre danú menu.

Predpokladajme, že váš marketingový tím potrebuje spustiť kampane pre tri regióny (US, EU, APAC), pričom každý má svoj vlastný rozpočet a menu. Vytvoríte tri peňaž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 prepojená s peňaženkou svojho regiónu. Ak sa v peňaženke pre US minú prostriedky, pozastavia sa iba kampane pre US. EU a APAC pokračujú bez ovplyvnenia. Môžete vykazovať výdavky, ROI a čerpanie podľa peňaženky a váš finančný tím môže každú peňaženku vyúčtovať samostatne.

{% hint style="info" %}
Inzerenti môžu používať peňaženky iba v katalógoch maloobchodníkov, ktoré podporujú rovnakú menu.
{% endhint %}

#### Viacero peňaženiek

Inzerenti môžu vytvoriť viacero peňaženiek na základe svojho prevádzkového modelu. Každá kampaň môže byť v danom čase prepojená iba s jednou peňaženkou, čo zaisťuje jasné oddelenie rozpočtu a sledovanie výdavkov. Ak nechcete vytvárať viacero peňaženiek, môžete použiť predvolenú peňaženku.

#### Organizácia rozpočtu naprieč peňaženkami

Peňaženky pomáhajú spoločnostiam spravovať ich reklamné rozpočty organizovaním prostriedkov na základe meny a účelu. Napríklad veľké organizácie môžu vytvoriť samostatné peňaženky pre rôzne oddelenia alebo kampane. Toto nastavenie umožňuje každej skupine kontrolovať svoje vlastné denné výdavky bez ovplyvnenia ostatných.

Každá peňaženka si udržiava úverový zostatok vo svojej určenej mene, čo uľahčuje správu rozpočtov vo viacerých menách. Inzerenti môžu vytvoriť viacero peňaženiek, z ktorých každá má svoj vlastný úverový zostatok a jedinečné ID peňaženky. Toto ID sa používa na identifikáciu a správu jednotlivých peňaženiek.

{% hint style="info" %}
Na spustenie kampane potrebujete v peňaženke dostatok prostriedkov. Keď peňaženka dosiahne svoj nastavený rozpočet, reklama sa prestane zobrazovať.
{% endhint %}

Keďže každá kampaň môže byť v danom čase prepojená iba s jednou peňaženkou, efektívna správa zostatkov v peňaženke je kľúčová pre neprerušené doručovanie kampane.

#### Kompatibilita meny s katalógmi

Niektoré funkcie peňaženky, ako napríklad vytváranie alebo úprava peňaženiek, nemusia byť dostupné pre všetkých inzerentov v závislosti od konfigurácie maloobchodníka. Ak má maloobchodník obmedzenia, uvidíte príslušné chybové správy a určité funkcie súvisiace s peňaženkou môžu byť v UI skryté.

Pri vytváraní kampane a výbere katalógu je každý katalóg spojený so špecifickou menou. Musíte si vybrať peňaženku, ktorá sa zhoduje s menou katalógu. Napríklad ak váš katalóg používa AUD (austrálsky dolár), nemôžete vybrať peňaženku v GBP (britská libra). Systém vám zabráni vybrať nezhodujúcu sa menu počas vytvárania kampane.

### Funkcie peňaženky

Peňaženky vám pomáhajú spravovať rozpočty a výdavky naprieč kampaňami, vrátane:

* **Podpora viacerých peňaženiek**: Umožňuje oddelenie rozpočtu podľa tímu, kampane alebo oddelenia.
* **Peňaženky špecifické pre menu**: Fungujú v jednej mene.
* **Archivované peňaženky**: Uchovávajú históriu bez ovplyvnenia aktívnych kampaní.

### Prvky peňaženky

Každá peňaženka obsahuje nasledujúce kľúčové prvky:

| Názov             | Popis                                                                                                                                                              |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Názov peňaženky   | Názov priradený peňaženke.                                                                                                                                         |
| ID peňaženky      | Jedinečný identifikátor používaný na účtovanie správnej peňaženky za kampaň.                                                                                       |
| Mena              | Mena, v ktorej peňaženka funguje.                                                                                                                                  |
| Aktuálny zostatok | Zostatok peňaženky bez akéhokoľvek úverového limitu.                                                                                                               |
| Dostupný zostatok | Celková suma k dispozícii na minutie, vrátane úverového limitu.                                                                                                    |
| Úverový limit     | <p>Povolené prekročenie výdavkov, ktoré sa obnovuje mesačne.<br><strong>Poznámka</strong>: Toto je zastaraná funkcia a väčšina maloobchodníkov ju nepodporuje.</p> |
| Stav archivácie   | Označuje, že peňaženka už nie je aktívna, ale je uchovaná pre záznamy.                                                                                             |

Vaše tímové peňaženky si môžete zobraziť v sekcii **Peňaženky**. V závislosti od konfigurácie vášho maloobchodníka môžete mať prístup na zobrazenie alebo úpravu špecifických nastavení peňaženky.

#### Príklad

Spoločnosť A plánuje rozdeliť svoj reklamný rozpočet medzi tri typy produktov: 10 000 $ pre Produkt A, 5 000 $ pre Produkt B a 1 200 $ pre Produkt C. Na spravovanie tohto stavu spoločnosť vytvorí tri samostatné peňaženky, jednu pre každý typ produktu s príslušnými sumami.

Pri nastavovaní kampaní je každá kampaň prepojená s peňaženkou priradenou k jej príslušnému produktu. Toto nastavenie umožňuje tímu kontrolovať a monitorovať reklamné výdavky pre každý typ produktu nezávisle, čím sa zaručí, že rozpočty sa použijú tak, ako bolo zamýšľané.

#### Čo je External ID?

**External ID** je voliteľné pole, do ktorého môžete uložiť vlastné referenčné čísla, ako je nákupná objednávka, Salesforce ID alebo číslo Placement IO. Pomáha partnerom sledovať a prepojiť peňaženku s ich vlastnými systémami.

> **Poznámka:** Toto pole je viditeľné iba vtedy, ak váš maloobchodník povolil túto funkciu.

### Limit rozpočtu a čerpanie

Na pomoc inzerentom pri efektívnej správe ich denných reklamných výdavkov podporujú peňaženky nasledujúce ovládacie prvky:

#### Denný limit / Denné výdavky

Maximálna suma, ktorú smie peňaženka minúť za jediný deň. Tento strop zaisťuje, že kampane neprekročia vopred definovaný denný rozpočet.

#### Čerpanie rozpočtu

Ak sa v daný deň neminie celý denný limit, neminutá suma sa presúva do nasledujúceho dňa. To umožňuje flexibilné čerpanie rozpočtu počas viacerých dní.

#### Zostávajúci denný limit

Časť denného limitu, ktorá zostala neminutá z predchádzajúceho dňa. Táto suma sa pripočíta k dennému limitu na nasledujúci deň, čo umožňuje kumulatívnu flexibilitu výdavkov.

> **Poznámka:** Dostupnosť denných limitov rozpočtu závisí od toho, či maloobchodník povolí túto funkciu.

### Dostupné koncové body

| Koncový bod                                                                                                 | Popis                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| [Create wallet](/retail-media-interface/partner/sk/billing-api/wallet/createwallet.md)                      | Nástroj na nastavenie novej peňaženky s priestorom názvov, tímom, názvom, menou, denným rozpočtom a voliteľným externým ID. |
| [Update wallet](/retail-media-interface/partner/sk/billing-api/wallet/updatewallet-1.md)                    | Upravte názov peňaženky, menu, denný rozpočet, úverový limit alebo externé ID.                                              |
| [Retrieve wallet by ID](/retail-media-interface/partner/sk/billing-api/wallet/getwallet-1.md)               | Získajte podrobnosti o peňaženke pomocou jej jedinečného identifikátora.                                                    |
| [List all wallets](/retail-media-interface/partner/sk/billing-api/wallet/listwallets.md)                    | Získajte zoznam všetkých peňaženiek priradených k vášmu tímu.                                                               |
| [Get balance of specific wallet](/retail-media-interface/partner/sk/billing-api/wallet/getwalletbalance.md) | Skontrolujte aktuálne a dostupné zostatky pomocou jej jedinečného identifikátora.                                           |
| [Manage funds to specific wallet](/retail-media-interface/partner/sk/billing-api/wallet/managefunds.md)     | Pridajte prostriedky do peňaženky na zvýšenie jej dostupného zostatku na výdavky na kampaň.                                 |

### Definície polí Wallet API

Nasledujú kľúčové polia peňaženky bežne používané v požiadavkách a odpovediach API:

| Pole             | Popis                                                                                                                                               |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId         | Jedinečný identifikátor pre peňaženku.                                                                                                              |
| currency         | Kód meny (napr. USD, EUR).                                                                                                                          |
| creditLimit      | <p>Mesačné povolenie na prekročenie výdavkov.<br><strong>Poznámka</strong>: Toto je zastaraná funkcia a väčšina maloobchodníkov ju nepodporuje.</p> |
| dailyBudget      | Denný strop výdavkov.                                                                                                                               |
| availableBalance | Suma na minutie vrátane úveru.                                                                                                                      |
| currentBalance   | Skutočný zostatok v peňaženke bez úveru.                                                                                                            |
| externalId       | Voliteľné pole pre čísla objednávok, Salesforce ID atď.                                                                                             |
| archived         | Booleovská príznaka označujúca, či je peňaženka archivovaná.                                                                                        |

Často kladené otázky a riešenie problémov nájdete v časti [Často kladené otázky](/retail-media-interface/partner/sk/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/sk/billing-api/wallet.md?ask=<question>&goal=<endgoal>
```

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