> 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/es/billing-api/wallet.md). # Monedero ## Descripción general La API de monedero permite a los anunciantes gestionar los monederos digitales utilizados para el presupuesto de campañas y el control del gasto. Cada monedero está vinculado a una sola moneda y equipo, y admite funciones como presupuestos diarios y gestión de fondos. Los anunciantes pueden mantener múltiples monederos, cada uno con su propio saldo de crédito y controles de gasto. Con estas API, puedes: * Gestionar nombres de monederos * Ver IDs de monederos * Acceder a códigos de moneda * Establecer presupuestos diarios * Consultar saldos actuales * Ver saldos disponibles * Controlar estados archivados * Gestionar fondos (solo retailers), y más ### Fundamentos del monedero #### Propósito Los monederos son herramientas esenciales para que los anunciantes gestionen, controlen y elaboren informes sobre los presupuestos de las campañas. Permiten un seguimiento granular por región, producto o equipo, y admiten presupuestos y control de gasto específicos para cada moneda. Supongamos que tu equipo de marketing necesita ejecutar campañas para tres regiones (EE. UU., UE, APAC), cada una con su propio presupuesto y moneda. Creas tres monederos: * **Monedero de EE. UU. (USD)**: 20.000 $, límite diario de 2.000 $. * **Monedero de la UE (EUR)**: 15.000 €, límite diario de 1.500 €. * **Monedero de APAC (AUD)**: 10.000 A$, límite diario de 1.000 A$. Cada campaña está vinculada al monedero de su región. Si el monedero de EE. UU. se queda con fondos bajos, solo se pausan las campañas de EE. UU. La UE y APAC continúan sin verse afectadas. Puedes elaborar informes sobre el gasto, el ROI y el ritmo de consumo por monedero, y tu equipo de finanzas puede conciliar cada monedero por separado. {% hint style="info" %} Los anunciantes solo pueden usar monederos en catálogos de retailer que admitan la misma moneda. {% endhint %} #### Múltiples monederos Los anunciantes pueden crear múltiples monederos según su modelo operativo. Cada campaña solo se puede vincular a un monedero a la vez, lo que garantiza una separación clara del presupuesto y el seguimiento del gasto. Eres libre de usar el monedero predeterminado si no deseas crear múltiples monederos. #### Organización del presupuesto entre monederos Los monederos ayudan a las empresas a gestionar sus presupuestos publicitarios organizando los fondos según la moneda y el propósito. Por ejemplo, las grandes organizaciones pueden crear monederos independientes para diferentes departamentos o campañas. Esta configuración permite que cada grupo controle su propio gasto diario sin afectar a los demás. Cada monedero mantiene un saldo de crédito en su moneda designada, lo que facilita la gestión de presupuestos en múltiples monedas. Los anunciantes pueden crear múltiples monederos, cada uno con su propio saldo de crédito e ID de monedero único. Este ID se utiliza para identificar y gestionar los monederos de forma individual. {% hint style="info" %} Necesitas fondos suficientes en tu monedero para ejecutar una campaña. Una vez que el monedero alcanza su presupuesto establecido, el anuncio deja de ejecutarse. {% endhint %} Dado que cada campaña solo se puede vincular a un monedero a la vez, gestionar los saldos del monedero de manera eficaz es crucial para una entrega de campañas sin interrupciones. #### Compatibilidad de moneda con catálogos Es posible que algunas funciones del monedero, como crear o editar monederos, no estén disponibles para todos los anunciantes, según la configuración del retailer. Si un retailer tiene restricciones, verás los mensajes de error correspondientes y es posible que ciertas funciones relacionadas con el monedero estén ocultas en la interfaz de usuario. Al crear una campaña y seleccionar un catálogo, cada catálogo se asocia con una moneda específica. Debes elegir un monedero que coincida con la moneda del catálogo. Por ejemplo, si tu catálogo utiliza AUD (dólar australiano), no puedes seleccionar un monedero en GBP (libra esterlina). El sistema te impedirá seleccionar una moneda no coincidente durante la creación de la campaña. ### Funciones del monedero Los monederos te ayudan a gestionar los presupuestos y el gasto en todas las campañas, incluyendo: * **Soporte multimonedero**: Permite la separación del presupuesto por equipo, campaña o departamento. * **Monederos con moneda específica**: Funciona en una sola moneda. * **Monederos archivados**: Conserva el historial sin afectar a las campañas activas. ### Elementos del monedero Cada monedero incluye los siguientes elementos clave: | Nombre | Descripción | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Nombre del monedero | El nombre asignado al monedero. | | ID del monedero | Un identificador único utilizado para cobrar al monedero correcto una campaña. | | Moneda | La moneda en la que opera el monedero. | | Saldo actual | El saldo del monedero excluyendo cualquier límite de crédito. | | Saldo disponible | El importe total gastable, incluido el límite de crédito. | | Límite de crédito |

Un margen de sobregasto que se restablece mensualmente.
Nota: Esta es una función heredada y la mayoría de los retailers no la admiten.

| | Estado archivado | Indica que el monedero ya no está activo pero se conserva para el registro. | Puedes ver los monederos de tu equipo en la sección **Monederos**. Según la configuración de tu retailer, es posible que tengas acceso para ver o modificar ajustes específicos del monedero. #### Ejemplo La Empresa A planea asignar su presupuesto publicitario entre tres tipos de productos: 10.000 $ para el Producto A, 5.000 $ para el Producto B y 1.200 $ para el Producto C. Para gestionar esto, la empresa crea tres monederos independientes, uno para cada tipo de producto con sus importes correspondientes. Al configurar las campañas, cada una se vincula al monedero asignado a su respectivo producto. Esta configuración permite al equipo controlar y supervisar el gasto publicitario de cada tipo de producto de forma independiente, garantizando que los presupuestos se utilicen según lo previsto. #### ¿Qué es un ID externo? Un **ID externo** es un campo opcional donde puedes almacenar números de referencia personalizados como un pedido de compra, ID de Salesforce o número de Placement IO. Ayuda a los socios a realizar el seguimiento y vincular el monedero a sus propios sistemas. > **Nota:** Este campo solo es visible si tu retailer ha habilitado la marca de función. ### Límite de presupuesto y ritmo de consumo Para ayudar a los anunciantes a gestionar su gasto publicitario diario de manera eficaz, los monederos admiten los siguientes controles: #### Límite diario / Gasto diario El importe máximo que un monedero tiene permitido gastar en un solo día. Este límite garantiza que las campañas no superen un presupuesto diario predefinido. #### Ritmo de consumo del presupuesto Si no se gasta todo el límite diario en un día determinado, el importe no gastado se acumula para el día siguiente. Esto permite un ritmo de consumo flexible del presupuesto a lo largo de varios días. #### Límite diario restante La porción del límite diario que no se ha gastado del día anterior. Este importe se suma al límite diario del día siguiente, lo que permite una flexibilidad de gasto acumulativa. > **Nota:** La disponibilidad de los límites de presupuesto diario está sujeta a que el retailer habilite la marca de función. ### Endpoints disponibles | Endpoint | Descripción | | ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | [Crear monedero](/retail-media-interface/partner/es/billing-api/wallet/createwallet.md) | Configura un nuevo monedero con un espacio de nombres, equipo, nombre, moneda, presupuesto diario y un ID externo opcional. | | [Actualizar monedero](/retail-media-interface/partner/es/billing-api/wallet/updatewallet-1.md) | Modifica el nombre del monedero, la moneda, el presupuesto diario, el límite de crédito o el ID externo. | | [Recuperar monedero por ID](/retail-media-interface/partner/es/billing-api/wallet/getwallet-1.md) | Obtén los detalles del monedero mediante su identificador único. | | [Enumerar todos los monederos](/retail-media-interface/partner/es/billing-api/wallet/listwallets.md) | Obtén una lista de todos los monederos asociados a tu equipo. | | [Obtener el saldo de un monedero específico](/retail-media-interface/partner/es/billing-api/wallet/getwalletbalance.md) | Consulta los saldos actual y disponible mediante su identificador único. | | [Gestionar fondos para un monedero específico](/retail-media-interface/partner/es/billing-api/wallet/managefunds.md) | Añade fondos a un monedero para aumentar su saldo disponible para el gasto en campañas. | ### Definiciones de campos de la API de monedero A continuación se presentan los campos clave del monedero que se utilizan habitualmente en las solicitudes y respuestas de la API: | Campo | Descripción | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | walletId | Identificador único para el monedero. | | currency | Código de moneda (por ejemplo, USD, EUR). | | creditLimit |

Margen de sobregasto mensual.
Nota: Esta es una función heredada y la mayoría de los retailers no la admiten.

| | dailyBudget | Límite de gasto diario. | | availableBalance | Importe gastable incluyendo crédito. | | currentBalance | Saldo real del monedero excluyendo el crédito. | | externalId | Campo opcional para números de orden de compra, ID de Salesforce, etc. | | archived | Indicador booleano que muestra si el monedero está archivado. | Para preguntas frecuentes y solución de problemas, consulta [Preguntas frecuentes](/retail-media-interface/partner/es/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/es/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.