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

# Pénztárca

## Áttekintés

A pénztárca API lehetővé teszi a hirdetők számára a kampánybüdzsékhez és a költésellenőrzéshez használt digitális pénztárcák kezelését. Minden pénztárca egyetlen pénznemhez és csapathoz van kötve, és támogatja az olyan funkciókat, mint a napi büdzsék és az egyenlegkezelés.

A hirdetők több pénztárcát is fenntarthatnak, mindegyiket saját hitelkerettel és költési korlátokkal. Ezekkel az API-kkal a következőket teheti:

* Pénztárcanevek kezelése
* Pénztárcaazonosítók megtekintése
* Pénznemkódok elérése
* Napi büdzsék beállítása
* Jelenlegi egyenlegek ellenőrzése
* Elérhető egyenlegek megtekintése
* Archiválási állapotok kezelése
* Módot ad az egyenlegek kezelésére (csak kiskereskedőknek), és még sok másra

### A pénztárcák alapjai

#### Cél

A pénztárcák elengedhetetlen eszközök a hirdetők számára a kampánybüdzsék kezeléséhez, ellenőrzéséhez és a róluk való jelentéstételhez. Lehetővé teszik a részletes nyomon követést régió, termék vagy csapat szerint, és támogatják a pénznemspecifikus büdzsékezelést és költésellenőrzést.

Tegyük fel, hogy a marketingcsapatának három régióban (US, EU, APAC) kell kampányokat futtatnia, mindegyikben saját büdzsével és pénznemmel. Létrehoz három pénztárcát:

* **US Wallet (USD)**: $20,000, napi limit $2,000.
* **EU Wallet (EUR)**: €15,000, napi limit €1,500.
* **APAC Wallet (AUD)**: A$10,000, napi limit A$1,000.

Minden kampány a saját régiójának pénztárcájához van kapcsolva. Ha az US pénztárca egyenlege lecsökken, csak az US kampányok állnak le. Az EU és az APAC zavartalanul folytatódik. Pénztárcánként jelentést tehet a költésről, a ROI-ról és a ütemezésről (pacing), a pénzügyi csapata pedig külön egyeztetheti az egyes pénztárcákat.

{% hint style="info" %}
A hirdetők csak olyan kiskereskedői katalógusoknál használhatnak pénztárcákat, amelyek ugyanazt a pénznemet támogatják.
{% endhint %}

#### Több pénztárca

A hirdetők működési modelljük alapján több pénztárcát is létrehozhatnak. Minden kampány egyszerre csak egy pénztárcához kapcsolható, biztosítva a büdzsék egyértelmű elkülönítését és a költések nyomon követését. Ha nem kíván több pénztárcát létrehozni, nyugodtan használhatja az alapértelmezett pénztárcát.

#### Büdzsék szervezése a pénztárcák között

A pénztárcák segítenek a vállalatoknak reklámbüdzséik kezelésében azáltal, hogy a pénzeszközöket pénznem és cél alapján rendszerezik. Például a nagy szervezetek külön pénztárcákat hozhatnak létre a különböző részlegek vagy kampányok számára. Ez a beállítás lehetővé teszi, hogy mindegyik csoport a többiek befolyásolása nélkül szabályozza a saját napi költéseit.

Minden pénztárca a kijelölt pénznemben tartja nyilván a hitelegyenlegét, megkönnyítve a büdzsék kezelését több pénznem esetén. A hirdetők több pénztárcát is létrehozhatnak, mindegyiket saját hitelegyenleggel és egyedi pénztárcaazonosítóval. Ez az azonosító a pénztárcák egyedi azonosítására és kezelésére szolgál.

{% hint style="info" %}
Elegendő pénzeszközre van szüksége a pénztárcájában a kampány futtatásához. Amint a pénztárca eléri a beállított büdzsét, a hirdetés futtatása leáll.
{% endhint %}

Mivel minden kampány egyszerre csak egy pénztárcához kapcsolható, a pénztárcaegyenlegek hatékony kezelése elengedhetetlen a kampányok megszakítás nélküli kézbesítéséhez.

#### Pénznemek kompatibilitása a katalógusokkal

Bizonyos pénztárcafunkciók, például a pénztárcák létrehozása vagy szerkesztése, a kiskereskedő konfigurációjától függően előfordulhat, hogy nem érhetők el minden hirdető számára. Ha egy kiskereskedőnél korlátozások vannak érvényben, idevágó hibaüzeneteket fog látni, és bizonyos pénztárcával kapcsolatos funkciók rejtve maradhatnak a felhasználói felületen.

Kampány létrehozásakor és katalógus kiválasztásakor minden katalógus egy adott pénznemhez van társítva. Olyan pénztárcát kell választania, amely megegyezik a katalógus pénznemével. Például, ha a katalógusa AUD-ot (Ausztrál dollár) használ, nem választhat GBP (Brit font) alapú pénztárcát. A rendszer megakadályozza a nem egyező pénznem kiválasztását a kampány létrehozása során.

### Pénztárcafunkciók

A pénztárcák segítenek a büdzsék és a költések kezelésében a kampányok során, beleértve a következőket:

* **Több pénztárca támogatása**: Lehetővé teszi a büdzsé elkülönítését csapat, kampány vagy részleg szerint.
* **Pénznemspecifikus pénztárcák**: Egyetlen pénznemben működik.
* **Archivált pénztárcák**: Megőrzi az előzményeket anélkül, hogy befolyásolná az aktív kampányokat.

### Pénztárcaelemek

Minden pénztárca a következő fő elemeket tartalmazza:

| Név                | Leírás                                                                                                                                             |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pénztárca neve     | A pénztárcához rendelt név.                                                                                                                        |
| Wallet ID          | Egyedi azonosító, amellyel a megfelelő pénztárcát terhelik meg egy kampányért.                                                                     |
| Pénznem            | Az a pénznem, amelyben a pénztárca működik.                                                                                                        |
| Jelenlegi egyenleg | A pénztárca egyenlege a hitelkeret nélkül.                                                                                                         |
| Elérhető egyenleg  | A teljes elkölthető összeg, beleértve a hitelkeretet is.                                                                                           |
| Hitelkeret         | <p>Túllépési keret, amely havonta nullázódik.<br><strong>Megjegyzés</strong>: Ez egy elavult funkció, és a legtöbb kiskereskedő nem támogatja.</p> |
| Archivált állapot  | Jelzi, hogy a pénztárca már nem aktív, de a nyilvántartások miatt meg van őrizve.                                                                  |

A csapata pénztárcáit a **Pénztárcák** részben tekintheti meg. A kiskereskedő konfigurációjától függően hozzáférése lehet az egyes pénztárcabeállítások megtekintéséhez vagy módosításához.

#### Példa

Az A vállalat azt tervezi, hogy a reklámbüdzséjét három terméktípus között osztja meg: $10 000-t az A termékre, $5 000-t a B termékre és $1 200-t a C termékre. Ennek kezelésére a vállalat három különálló pénztárcát hoz létre, minden terméktípushoz egyet a megfelelő összegekkel.

A kampányok beállításakor minden kampány a hozzá tartozó termékhez rendelt pénztárcához kapcsolódik. Ez a beállítás lehetővé teszi a csapat számára, hogy egymástól függetlenül szabályozza és figyelemmel kísérje az egyes terméktípusok reklámköltéseit, biztosítva, hogy a büdzséket a tervezett módon használják fel.

#### Mi az az External ID?

Az **external ID** egy opcionális mező, ahol egyedi hivatkozási számokat tárolhat, például megrendelést (purchase order), Salesforce ID-t vagy Placement IO számot. Segít a partnereknek nyomon követni és összekapcsolni a pénztárcát a saját rendszereikkel.

> **Megjegyzés:** Ez a mező csak akkor látható, ha a kiskereskedő engedélyezte a funkciózászlót (feature flag).

### Büdzsékorlát és ütemezés

Hogy segítsen a hirdetőknek a napi hirdetési költéseik hatékony kezelésében, a pénztárcák a következő vezérlőket támogatják:

#### Napi limit / Napi költés

A maximális összeg, amelyet egy pénztárca egyetlen nap alatt elkölthet. Ez a korlát biztosítja, hogy a kampányok ne lépjék túl az előre meghatározott napi büdzsét.

#### Büdzsé ütemezése (pacing)

Ha a teljes napi limitet nem költik el egy adott napon, a felnemhasznált összeg átkerül a következő napra. Ez lehetővé teszi a büdzsé rugalmas ütemezését több napon keresztül.

#### Fennmaradó napi limit

A napi limit azon része, amely az előző napról felnemhasznált maradt. Ez az összeg hozzáadódik a következő napi limitszámhoz, lehetővé téve a kumulatív költési rugalmasságot.

> **Megjegyzés:** A napi büdzsélimit elérhetősége attól függ, hogy a kiskereskedő engedélyezi-e a funkciózászlót (feature flag).

### Elérhető végpontok

| Végpont                                                                                                     | Leírás                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| [Create wallet](/retail-media-interface/partner/hu/billing-api/wallet/createwallet.md)                      | Hozzon létre egy új tárcát névtérrel, csapattal, névvel, pénznemmel, napi költségkerettel és opcionális külső azonosítóval. |
| [Update wallet](/retail-media-interface/partner/hu/billing-api/wallet/updatewallet-1.md)                    | Módosítsa a tárca nevét, pénznemét, napi költségkeretét, hitellimitjét vagy külső azonosítóját.                             |
| [Retrieve wallet by ID](/retail-media-interface/partner/hu/billing-api/wallet/getwallet-1.md)               | Lkérje a tárca részleteit az egyedi azonosítójával.                                                                         |
| [List all wallets](/retail-media-interface/partner/hu/billing-api/wallet/listwallets.md)                    | Lekérje a csapatához társított összes tárca listáját.                                                                       |
| [Get balance of specific wallet](/retail-media-interface/partner/hu/billing-api/wallet/getwalletbalance.md) | Ellenőrizze a jelenlegi és elérhető egyenlegeket az egyedi azonosítójával.                                                  |
| [Manage funds to specific wallet](/retail-media-interface/partner/hu/billing-api/wallet/managefunds.md)     | Pénzeszközök hozzáadása a tárcához az elérhető egyenleg növelése érdekében a kampányköltésekhez.                            |

### Tárca API meződefiníciók

A következő kulcsfontosságú tárcamezőket használják általánosan az API-kérésekben és -válaszokban:

| Mező             | Leírás                                                                                                                        |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| walletId         | A tárca egyedi azonosítója.                                                                                                   |
| currency         | Pénznemkód (pl. USD, EUR).                                                                                                    |
| creditLimit      | <p>Havi túllépési keret.<br><strong>Megjegyzés</strong>: Ez egy elavult funkció, és a legtöbb kiskereskedő nem támogatja.</p> |
| dailyBudget      | Napi költési limit.                                                                                                           |
| availableBalance | Elkölthető összeg, beleértve a hitelt is.                                                                                     |
| currentBalance   | Tényleges tárcaegyenleg a hitel nélkül.                                                                                       |
| externalId       | Opcionális mező megrendelésszámokhoz, Salesforce ID-khoz stb.                                                                 |
| archived         | Azt jelző boolean flag, hogy a tárca archiválva van-e.                                                                        |

A gyakori kérdésekért és a hibaelhárításért lásd: [Gyakran ismételt kérdések](/retail-media-interface/partner/hu/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/hu/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.