> 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/it/billing-api/wallet.md).
# Wallet
## Panoramica
L'API wallet consente agli inserzionisti di gestire i wallet digitali utilizzati per il budgeting delle campagne e il controllo della spesa. Ogni wallet è collegato a una singola valuta e a un unico team, e supporta funzionalità come budget giornalieri e gestione dei fondi.
Gli inserzionisti possono mantenere più wallet, ciascuno con il proprio saldo di credito e i propri controlli di spesa. Con queste API è possibile:
* Gestire i nomi dei wallet
* Visualizzare gli ID dei wallet
* Accedere ai codici valuta
* Impostare i budget giornalieri
* Verificare i saldi correnti
* Visualizzare i saldi disponibili
* Controllare gli stati di archiviazione
* Gestire i fondi (solo per i retailer) e altro ancora
### Concetti fondamentali del wallet
#### Scopo
I wallet sono strumenti essenziali per consentire agli inserzionisti di gestire, controllare e rendicontare i budget delle campagne. Consentono un tracciamento granulare per regione, prodotto o team, e supportano il budgeting e il controllo della spesa specifici per valuta.
Supponiamo che il tuo team di marketing debba pubblicare campagne per tre regioni (US, EU, APAC), ciascuna con un proprio budget e una propria valuta. Crei tre wallet:
* **US Wallet (USD)**: $ 20.000, limite giornaliero $ 2.000.
* **EU Wallet (EUR)**: € 15.000, limite giornaliero € 1.500.
* **APAC Wallet (AUD)**: A$ 10.000, limite giornaliero A$ 1.000.
Ogni campagna è collegata al wallet della propria regione. Se il wallet US esaurisce i fondi, si interrompono solo le campagne US. EU e APAC continuano senza variazioni. Puoi generare report su spesa, ROI e pacing per wallet, e il tuo team finanziario può riconciliare ciascun wallet separatamente.
{% hint style="info" %}
Gli inserzionisti possono utilizzare i wallet solo sui cataloghi del retailer che supportano la stessa valuta.
{% endhint %}
#### Wallet multipli
Gli inserzionisti possono creare più wallet in base al proprio modello operativo. Ogni campagna può essere collegata a un solo wallet alla volta, garantendo una chiara separazione del budget e il tracciamento della spesa. Sei libero di utilizzare il wallet predefinito se non desideri creare più wallet.
#### Organizzazione del budget tra i wallet
I wallet aiutano le aziende a gestire i propri budget pubblicitari organizzando i fondi in base alla valuta e allo scopo. Ad esempio, le grandi organizzazioni possono creare wallet separati per diversi dipartimenti o campagne. Questa configurazione consente a ciascun gruppo di controllare la propria spesa giornaliera senza impattare sugli altri.
Ciascun wallet mantiene un saldo di credito nella valuta designata, rendendo più facile la gestione dei budget su più valute. Gli inserzionisti possono creare più wallet, ciascuno con il proprio saldo di credito e l'ID wallet univoco. Questo ID viene utilizzato per identificare e gestire i wallet singolarmente.
{% hint style="info" %}
È necessario disporre di fondi sufficienti nel wallet per pubblicare una campagna. Una volta che il wallet raggiunge il budget impostato, l'annuncio smette di essere erogato.
{% endhint %}
Poiché ogni campagna può essere collegata a un solo wallet alla volta, la gestione efficace dei saldi dei wallet è fondamentale per un'erogazione ininterrotta della campagna.
#### Compatibilità della valuta con i cataloghi
Alcune funzionalità del wallet, come la creazione o la modifica dei wallet, potrebbero non essere disponibili per tutti gli inserzionisti, a seconda della configurazione del retailer. Se un retailer applica delle restrizioni, visualizzerai i messaggi di errore pertinenti e alcune funzioni relative al wallet potrebbero essere nascoste nell'interfaccia utente.
Quando si crea una campagna e si seleziona un catalogo, ciascun catalogo è associato a una valuta specifica. È necessario scegliere un wallet corrispondente alla valuta del catalogo. Ad esempio, se il tuo catalogo utilizza AUD (Dollaro australiano), non puoi selezionare un wallet in GBP (Sterlina britannica). Il sistema ti impedirà di selezionare una valuta non corrispondente durante la creazione della campagna.
### Funzionalità del wallet
I wallet ti aiutano a gestire i budget e le spese tra le campagne, tra cui:
* **Supporto multi-wallet**: Consente la separazione del budget per team, campagna o dipartimento.
* **Wallet specifici per valuta**: Operano in un'unica valuta.
* **Wallet archiviati**: Mantengono lo storico senza influire sulle campagne attive.
### Elementi del wallet
Ogni wallet include i seguenti elementi chiave:
| Nome | Descrizione |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Nome wallet | Il nome assegnato al wallet. |
| ID wallet | Un identificatore univoco utilizzato per addebitare il wallet corretto per una campagna. |
| Valuta | La valuta in cui opera il wallet. |
| Saldo corrente | Il saldo del wallet esclusi eventuali limiti di credito. |
| Saldo disponibile | L'importo totale spendibile, compreso il limite di credito. |
| Limite di credito | Una tolleranza di spesa in eccesso che si azzera mensilmente.
Nota: Questa è una funzionalità legacy e non è supportata dalla maggior parte dei retailer.
|
| Stato archiviato | Indica che il wallet non è più attivo ma viene conservato nei registri. |
Puoi visualizzare i wallet del tuo team nella sezione **Wallets**. A seconda della configurazione del retailer, potresti avere l'accesso per visualizzare o modificare specifiche impostazioni del wallet.
#### Esempio
L'Azienda A pianifica di allocare il proprio budget pubblicitario su tre tipi di prodotto: $ 10.000 per il Prodotto A, $ 5.000 per il Prodotto B e $ 1.200 per il Prodotto C. Per gestire questo, l'azienda crea tre wallet separati, uno per ciascun tipo di prodotto con i relativi importi.
Durante la configurazione delle campagne, ogni campagna viene collegata al wallet assegnato al rispettivo prodotto. Questa configurazione consente al team di controllare e monitorare la spesa pubblicitaria per ciascun tipo di prodotto in modo indipendente, garantendo che i budget vengano utilizzati come previsto.
#### Che cos'è un External ID?
Un **external ID** è un campo opzionale in cui è possibile memorizzare numeri di riferimento personalizzati come un ordine di acquisto, un ID Salesforce o un numero di Placement IO. Aiuta i partner a tracciare e collegare il wallet ai propri sistemi.
> **Nota:** Questo campo è visibile solo se il retailer ha abilitato il feature flag.
### Limite di budget e pacing
Per aiutare gli inserzionisti a gestire efficacemente la loro spesa pubblicitaria giornaliera, i wallet supportano i seguenti controlli:
#### Limite giornaliero / Spesa giornaliera
L'importo massimo che un wallet è autorizzato a spendere in un singolo giorno. Questo tetto garantisce che le campagne non superino un budget giornaliero predefinito.
#### Budget pacing
Se l'intero limite giornaliero non viene speso in un determinato giorno, l'importo non speso viene riportato al giorno successivo. Ciò consente una gestione flessibile del pacing del budget su più giorni.
#### Limite giornaliero rimanente
La porzione del limite giornaliero rimasta non spesa dal giorno precedente. Questo importo viene aggiunto al limite giornaliero del giorno successivo, consentendo flessibilità di spesa cumulativa.
> **Nota:** La disponibilità dei limiti di budget giornalieri è soggetta all'abilitazione del feature flag da parte del retailer.
### Endpoint disponibili
| Endpoint | Descrizione |
| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| [Crea wallet](/retail-media-interface/partner/it/billing-api/wallet/createwallet.md) | Configura un nuovo wallet con namespace, team, nome, valuta, budget giornaliero e ID esterno opzionale. |
| [Aggiorna wallet](/retail-media-interface/partner/it/billing-api/wallet/updatewallet-1.md) | Modifica il nome del wallet, la valuta, il budget giornaliero, il limite di credito o l'ID esterno. |
| [Recupera wallet tramite ID](/retail-media-interface/partner/it/billing-api/wallet/getwallet-1.md) | Recupera i dettagli del wallet utilizzando il suo identificatore univoco. |
| [Elenca tutti i wallet](/retail-media-interface/partner/it/billing-api/wallet/listwallets.md) | Ottieni un elenco di tutti i wallet associati al tuo team. |
| [Ottieni il saldo di uno specifico wallet](/retail-media-interface/partner/it/billing-api/wallet/getwalletbalance.md) | Verifica il saldo attuale e quello disponibile, utilizzando il suo identificatore univoco. |
| [Gestisci i fondi per uno specifico wallet](/retail-media-interface/partner/it/billing-api/wallet/managefunds.md) | Aggiungi fondi a un wallet per aumentare il saldo disponibile per la spesa della campagna. |
### Definizioni dei campi dell'API Wallet
Di seguito sono riportati i campi chiave del wallet comunemente utilizzati nelle richieste e nelle risposte API:
| Campo | Descrizione |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId | Identificatore univoco per il wallet. |
| currency | Codice valuta (ad es. USD, EUR). |
| creditLimit | Soglia mensile di spesa in eccesso consentita.
Nota: Questa è una funzionalità legacy e non è supportata dalla maggior parte dei retailer.
|
| dailyBudget | Limite di spesa giornaliero. |
| availableBalance | Importo spendibile incluso il credito. |
| currentBalance | Saldo effettivo del wallet escluso il credito. |
| externalId | Campo opzionale per numeri d'ordine (PO), ID Salesforce, ecc. |
| archived | Flag booleano che indica se il wallet è archiviato. |
Per le domande più comuni e la risoluzione dei problemi, consulta [Domande frequenti](/retail-media-interface/partner/it/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/it/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.