> 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/sv/billing-api/wallet.md).
# Plånbok
## Översikt
API:et för plånböcker gör det möjligt för annonsörer att hantera digitala plånböcker som används för kampanjbudgetering och utgiftskontroll. Varje plånbok är kopplad till en enskild valuta och ett team, och stöder funktioner som dagsbudgetar och fondhantering.
Annonsörer kan ha flera plånböcker, var och en med sitt eget kreditsaldo och sina egna utgiftskontroller. Med dessa API:er kan du:
* Hantera plånboksnamn
* Visa plånboks-ID:n
* Få åtkomst till valutakoder
* Ställa in dagsbudgetar
* Kontrollera aktuella saldon
* Visa tillgängliga saldon
* Styra arkiveringsstatusar
* Hantera medel (endast återförsäljare) med mera
### Grundläggande om plånböcker
#### Syfte
Plånböcker är avgörande verktyg för annonsörer för att hantera, kontrollera och rapportera om kampanjbudgetar. De möjliggör detaljerad spårning per region, produkt eller team och stöder valutaspecifik budgetering och utgiftskontroll.
Anta att ditt marknadsföringsteam behöver köra kampanjer för tre regioner (USA, EU, APAC), var och en med sin egen budget och valuta. Du skapar tre plånböcker:
* **US Wallet (USD)**: $20 000, dagsgräns $2 000.
* **EU Wallet (EUR)**: €15 000, dagsgräns €1 500.
* **APAC Wallet (AUD)**: A$10 000, dagsgräns A$1 000.
Varje kampanj är kopplad till sin regions plånbok. Om USA-plånboken börjar ta slut pausas endast USA-kampanjerna. EU och APAC fortsätter opåverkade. Du kan rapportera om utgifter, ROI och pacing per plånbok, och ditt ekonomiteam kan avstämma varje plånbok separat.
{% hint style="info" %}
Annonsörer kan endast använda plånböcker på återförsäljarkataloger som stöder samma valuta.
{% endhint %}
#### Flera plånböcker
Annonsörer kan skapa flera plånböcker baserat på sin driftsmodell. Varje kampanj kan bara kopplas till en plånbok i taget, vilket säkerställer tydlig budgetseparering och utgiftsspårning. Du kan använda standardplånboken om du inte vill skapa flera plånböcker.
#### Budgetorganisering över plånböcker
Plånböcker hjälper företag att hantera sina annonsbudgetar genom att organisera medel baserat på valuta och syfte. Stora organisationer kan till exempel skapa separata plånböcker för olika avdelningar eller kampanjer. Denna struktur gör det möjligt för varje grupp att kontrollera sina egna dagliga utgifter utan att påverka andra.
Varje plånbok har ett kreditsaldo i sin angivna valuta, vilket gör det enklare att hantera budgetar över flera valutor. Annonsörer kan skapa flera plånböcker, var och en med sitt eget kreditsaldo och unika plånboks-ID. Detta ID används för att identifiera och hantera plånböcker individuellt.
{% hint style="info" %}
Du behöver tillräckligt med medel i din plånbok för att köra en kampanj. När plånboken når sin inställda budget slutar annonsen att köras.
{% endhint %}
Eftersom varje kampanj endast kan kopplas till en plånbok i taget är effektiv hantering av plånbokssaldon avgörande för oavbruten kampanjleverans.
#### Valutakompatibilitet med kataloger
Vissa plånboksfunktioner, som att skapa eller redigera plånböcker, kanske inte är tillgängliga för alla annonsörer, beroende på återförsäljarens konfiguration. Om en återförsäljare har begränsningar ser du relevanta felmeddelanden, och vissa plånboksrelaterade funktioner kan vara dolda i användargränssnittet.
När du skapar en kampanj och väljer en katalog är varje katalog kopplad till en viss valuta. Du måste välja en plånbok som matchar katalogens valuta. Om din katalog till exempel använder AUD (australisk dollar) kan du inte välja en plånbok i GBP (brittiskt pund). Systemet förhindrar dig från att välja en felaktig valuta under skapandet av kampanjen.
### Plånboksfunktioner
Plånböcker hjälper dig att hantera budgetar och utgifter över kampanjer, inklusive:
* **Stöd för flera plånböcker**: Möjliggör budgetseparering per team, kampanj eller avdelning.
* **Valutaspecifika plånböcker**: Fungerar i en enskild valuta.
* **Arkiverade plånböcker**: Bevarar historik utan att påverka aktiva kampanjer.
### Element i plånboken
Varje plånbok innehåller följande nyckelelement:
| Namn | Beskrivning |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Plånboksnamn | Namnet som tilldelats plånboken. |
| Plånboks-ID | En unik identifierare som används för att debitera rätt plånbok för en kampanj. |
| Valuta | Den valuta som plånboken använder. |
| Aktuellt saldo | Plånbokens saldo exklusive eventuell kreditgräns. |
| Tillgängligt saldo | Det totala beloppet som kan spenderas, inklusive kreditgränsen. |
| Kreditgräns | Ett utrymme för överskridande av utgifter som återställs varje månad.
Obs!: Detta är en föråldrad funktion som inte stöds av de flesta återförsäljare.
|
| Arkiverad status | Indikerar att plånboken inte längre är aktiv men finns kvar för arkiveringsändamål. |
Du kan visa ditt teams plånböcker i avsnittet **Plånböcker**. Beroende på din återförsäljarkonfiguration kan du ha behörighet att visa eller ändra specifika plånboksinställningar.
#### Exempel
Företag A planerar att fördela sin annonsbudget på tre produkttyper: 10 000 USD för produkt A, 5 000 USD för produkt B och 1 200 USD för produkt C. För att hantera detta skapar företaget tre separata plånböcker, en för varje produkttyp med motsvarande belopp.
När kampanjer konfigureras kopplas varje kampanj till den plånbok som tilldelats dess respektive produkt. Denna struktur gör det möjligt för teamet att kontrollera och övervaka annonsutgifterna för varje produkttyp oberoende av varandra, vilket säkerställer att budgetarna används som avsett.
#### Vad är ett externt ID?
Ett **externt ID** är ett valfritt fält där du kan lagra anpassade referensnummer som ett inköpsordernummer, Salesforce ID eller Placement IO-nummer. Det hjälper partner att spåra och koppla plånboken till sina egna system.
> **Obs!** Detta fält är endast synligt om din återförsäljare har aktiverat funktionsflaggan.
### Budgetgräns och pacing
För att hjälpa annonsörer att hantera sina dagliga annonsutgifter effektivt stöder plånböcker följande kontroller:
#### Dagsgräns / Dagliga utgifter
Det maximala belopp som en plånbok får spendera under en enskild dag. Detta tak säkerställer att kampanjer inte överskrider en fördefinierad dagsbudget.
#### Budget pacing
Om hela dagsgränsen inte förbrukas under en viss dag förs det oanvända beloppet över till nästa dag. Detta möjliggör flexibel pacing av budgeten över flera dagar.
#### Återstående dagsgräns
Den del av dagsgränsen som återstår oanvänd från föregående dag. Detta belopp läggs till nästa dags dagsgräns, vilket möjliggör kumulativ flexibilitet i spenderandet.
> **Obs!** Tillgängligheten för dagsbudgetgränser förutsätter att återförsäljaren aktiverar funktionsflaggan.
### Tillgängliga slutpunkter
| Slutpunkt | Beskrivning |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| [Create wallet](/retail-media-interface/partner/sv/billing-api/wallet/createwallet.md) | Konfigurera en ny plånbok med en namnrymd, team, namn, valuta, dagsbudget och valfritt externt ID. |
| [Update wallet](/retail-media-interface/partner/sv/billing-api/wallet/updatewallet-1.md) | Ändra plånboksnamn, valuta, dagsbudget, kreditgräns eller externt ID. |
| [Retrieve wallet by ID](/retail-media-interface/partner/sv/billing-api/wallet/getwallet-1.md) | Hämta plånboksuppgifter med hjälp av dess unika identifierare. |
| [List all wallets](/retail-media-interface/partner/sv/billing-api/wallet/listwallets.md) | Hämta en lista över alla plånböcker som är kopplade till ditt team. |
| [Get balance of specific wallet](/retail-media-interface/partner/sv/billing-api/wallet/getwalletbalance.md) | Kontrollera aktuella och tillgängliga saldon med hjälp av dess unika identifierare. |
| [Manage funds to specific wallet](/retail-media-interface/partner/sv/billing-api/wallet/managefunds.md) | Lägg till medel i en plånbok för att öka dess tillgängliga saldo för kampanjutgifter. |
### Fältdefinitioner för Wallet API
Följande är viktiga plånboksfält som vanligtvis används i API-begäranden och -svar:
| Fält | Beskrivning |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId | Unik identifierare för plånboken. |
| currency | Valutakod (t.ex. USD, EUR). |
| creditLimit | Månatligt utrymme för övertrassering.
Obs!: Detta är en föråldrad funktion som inte stöds av de flesta återförsäljare.
|
| dailyBudget | Maksimalt belopp för dagsutgifter. |
| availableBalance | Spenderbart belopp inklusive kredit. |
| currentBalance | Faktiskt plånbokssaldo exklusive kredit. |
| externalId | Valfritt fält för inköpsordernummer, Salesforce-ID:n osv. |
| archived | Boolesk flagga som indikerar om plånboken är arkiverad. |
För vanliga frågor och felsökning, se [Vanliga frågor och ställda frågor](/retail-media-interface/partner/sv/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/sv/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.