> 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/ko/billing-api/wallet.md).
# 지갑
## 개요
지갑 API를 사용하면 광고주가 캠페인 예산 설정 및 지출 제어에 사용되는 디지털 지갑을 관리할 수 있습니다. 각 지갑은 단일 통화 및 팀에 연결되며, 일일 예산 및 자금 관리와 같은 기능을 지원합니다.
광고주는 각각 자체 신용 한도 및 지출 제어 기능을 갖춘 여러 지갑을 유지할 수 있습니다. 이 API를 사용하여 다음을 수행할 수 있습니다.
* 지갑 이름 관리
* 지갑 ID 조회
* 통화 코드 액세스
* 일일 예산 설정
* 현재 잔액 확인
* 사용 가능한 잔액 조회
* 보관 상태 제어
* 자금 관리(소매업체 전용) 등
### 지갑 기본 사항
#### 목적
지갑은 광고주가 캠페인 예산을 관리, 제어 및 보고하는 데 필수적인 도구입니다. 지역, 제품 또는 팀별로 세분화된 추적을 할 수 있으며, 통화별 예산 설정 및 지출 제어를 지원합니다.
마케팅 팀이 3개 지역(미국, 유럽, 아시아 태평양)에 대한 캠페인을 실행해야 하며, 각 지역마다 자체 예산과 통화가 있다고 가정해 보겠습니다. 3개의 지갑을 생성합니다.
* **미국 지갑 (USD)**: $20,000, 일일 한도 $2,000.
* **유럽 지갑 (EUR)**: €15,000, 일일 한도 €1,500.
* **아시아 태평양 지갑 (AUD)**: A$10,000, 일일 한도 A$1,000.
각 캠페인은 해당 지역의 지갑에 연결됩니다. 미국 지갑의 잔액이 부족해지면 미국 캠페인만 일시 중지됩니다. 유럽 및 아시아 태평양 캠페인은 영향 없이 계속 실행됩니다. 지갑별로 지출, ROI 및 페이싱을 보고할 수 있으며, 재무 팀은 각 지갑을 개별적으로 정산할 수 있습니다.
{% hint style="info" %}
광고주는 동일한 통화를 지원하는 소매업체 카탈로그에서만 지갑을 사용할 수 있습니다.
{% endhint %}
#### 다중 지갑
광고주는 운영 모델에 따라 여러 지갑을 생성할 수 있습니다. 각 캠페인은 한 번에 하나의 지갑에만 연결할 수 있으므로 명확한 예산 분리 및 지출 추적이 보장됩니다. 여러 지갑을 생성하지 않으려는 경우 기본 지갑을 자유롭게 사용할 수 있습니다.
#### 지갑 간 예산 조직
지갑은 통화 및 목적에 따라 자금을 구성하여 회사가 광고 예산을 관리하는 데 도움을 줍니다. 예를 들어, 대규모 조직은 서로 다른 부서나 캠페인을 위해 별도의 지갑을 생성할 수 있습니다. 이 설정을 통해 각 그룹은 다른 그룹에 영향을 주지 않고 자체 일일 지출을 제어할 수 있습니다.
각 지갑은 지정된 통화로 신용 잔액을 유지하므로 여러 통화에 걸쳐 예산을 더 쉽게 관리할 수 있습니다. 광고주는 각각 자체 신용 잔액과 고유한 지갑 ID를 가진 여러 지갑을 생성할 수 있습니다. 이 ID는 지갑을 개별적으로 식별하고 관리하는 데 사용됩니다.
{% hint style="info" %}
캠페인을 실행하려면 지갑에 충분한 자금이 있어야 합니다. 지갑이 설정된 예산에 도달하면 광고 실행이 중단됩니다.
{% endhint %}
각 캠페인은 한 번에 하나의 지갑에만 연결할 수 있으므로 지갑 잔액을 효과적으로 관리하는 것이 중단 없는 캠페인 게재에 매우 중요합니다.
#### 카탈로그와의 통화 호환성
지갑 생성 또는 수정과 같은 일부 지갑 기능은 소매업체의 설정에 따라 모든 광고주가 이용할 수 있는 것은 아닐 수 있습니다. 소매업체에 제한 사항이 있는 경우 관련 오류 메시지가 표시되며 일부 지갑 관련 기능이 UI에서 숨겨질 수 있습니다.
캠페인을 생성하고 카탈로그를 선택할 때 각 카탈로그는 특정 통화와 연결되어 있습니다. 카탈로그의 통화와 일치하는 지갑을 선택해야 합니다. 예를 들어 카탈로그에서 AUD(호주 달러)를 사용하는 경우 GBP(영국 파운드) 지갑을 선택할 수 없습니다. 시스템은 캠페인 생성 중에 일치하지 않는 통화를 선택하지 못하도록 차단합니다.
### 지갑 기능
지갑은 다음과 같이 캠페인 전반에 걸친 예산 및 지출 관리를 도와줍니다.
* **다중 지갑 지원**: 팀, 캠페인 또는 부서별로 예산을 분리할 수 있습니다.
* **통화 전용 지갑**: 단일 통화로 작동합니다.
* **보관된 지갑**: 활성 캠페인에 영향을 주지 않고 기록을 보관합니다.
### 지갑 구성 요소
각 지갑에는 다음과 같은 핵심 요소가 포함되어 있습니다.
| 이름 | 설명 |
| --------- | ------------------------------------------------------------------------------------------ |
| 지갑 이름 | 지갑에 할당된 이름입니다. |
| 지갑 ID | 캠페인에 대해 올바른 지갑에 비용을 청구하는 데 사용되는 고유 식별자입니다. |
| 통화 | 지갑이 작동하는 통화입니다. |
| 현재 잔액 | 신용 한도를 제외한 지갑의 잔액입니다. |
| 사용 가능한 잔액 | 신용 한도를 포함하여 지출 가능한 총 금액입니다. |
| 신용 한도 | 매월 재설정되는 초과 지출 한도입니다.
참고: 이 기능은 레거시 기능이며 대부분의 소매업체에서 지원되지 않습니다.
|
| 보관된 상태 | 지갑이 더 이상 활성 상태는 아니지만 기록을 위해 보관되어 있음을 나타냅니다. |
**지갑** 섹션에서 팀의 지갑을 볼 수 있습니다. 소매업체 설정에 따라 특정 지갑 설정을 조회하거나 수정할 수 있는 권한이 있을 수 있습니다.
#### 예시
A 회사는 광고 예산을 제품 A에 $10,000, 제품 B에 $5,000, 제품 C에 $1,200의 3가지 제품 유형에 할당할 계획입니다. 이를 관리하기 위해 회사는 각 제품 유형에 해당하는 금액으로 3개의 별도 지갑을 생성합니다.
캠페인을 설정할 때 각 캠페인은 해당 제품에 할당된 지갑에 연결됩니다. 이 설정을 통해 팀은 각 제품 유형에 대한 광고 지출을 독립적으로 제어하고 모니터링하여 예산이 의도한 대로 사용되도록 할 수 있습니다.
#### 외부 ID란 무엇인가요?
**외부 ID**는 구매 주문서, Salesforce ID 또는 Placement IO 번호와 같은 사용자 지정 참조 번호를 저장할 수 있는 선택적 필드입니다. 파트너가 지갑을 자체 시스템에 추적하고 연결하는 데 도움이 됩니다.
> **참고:** 이 필드는 소매업체가 기능 플래그를 활성화한 경우에만 표시됩니다.
### 예산 한도 및 페이싱
광고주가 일일 광고 지출을 효과적으로 관리할 수 있도록 지갑은 다음과 같은 제어 기능을 지원합니다.
#### 일일 한도 / 일일 지출
지갑이 하루 동안 지출할 수 있는 최대 금액입니다. 이 한도를 통해 캠페인이 미리 정의된 일일 예산을 초과하지 않도록 합니다.
#### 예산 페이싱
지정된 날짜에 일일 한도를 모두 지출하지 않은 경우 미지출 금액은 다음 날로 이월됩니다. 이를 통해 여러 날에 걸쳐 예산을 유연하게 페이싱할 수 있습니다.
#### 남은 일일 한도
이전 날에서 미지출 상태로 남아 있는 일일 한도의 일부입니다. 이 금액은 다음 날의 일일 한도에 추가되어 누적 지출 유연성을 제공합니다.
> **참고:** 일일 예산 한도의 제공 여부는 소매업체의 기능 플래그 활성화 여부에 따라 달라집니다.
### 사용 가능한 엔드포인트
| 엔드포인트 | 설명 |
| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [Create wallet](/retail-media-interface/partner/ko/billing-api/wallet/createwallet.md) | 네임스페이스, 팀, 이름, 통화, 일일 예산 및 선택 사항인 외부 ID를 사용하여 새 지갑을 설정합니다. |
| [Update wallet](/retail-media-interface/partner/ko/billing-api/wallet/updatewallet-1.md) | 지갑 이름, 통화, 일일 예산, 신용 한도 또는 외부 ID를 수정합니다. |
| [Retrieve wallet by ID](/retail-media-interface/partner/ko/billing-api/wallet/getwallet-1.md) | 고유 식별자를 사용하여 지갑 상세 정보를 가져옵니다. |
| [List all wallets](/retail-media-interface/partner/ko/billing-api/wallet/listwallets.md) | 팀과 관련된 모든 지갑 목록을 가져옵니다. |
| [Get balance of specific wallet](/retail-media-interface/partner/ko/billing-api/wallet/getwalletbalance.md) | 고유 식별자를 사용하여 현재 잔액 및 사용 가능한 잔액을 확인합니다. |
| [Manage funds to specific wallet](/retail-media-interface/partner/ko/billing-api/wallet/managefunds.md) | 캠페인 지출에 사용할 수 있는 잔액을 늘리기 위해 지갑에 자금을 추가합니다. |
### 지갑 API 필드 정의
다음은 API 요청 및 응답에서 일반적으로 사용되는 주요 지갑 필드입니다.
| 필드 | 설명 |
| ---------------- | ------------------------------------------------------------------------------------ |
| walletId | 지갑의 고유 식별자입니다. |
| currency | 통화 코드(예: USD, EUR). |
| creditLimit | 월별 초과 지출 한도입니다.
참고: 이 기능은 레거시 기능이며 대부분의 소매업체에서 지원되지 않습니다.
|
| dailyBudget | 일일 지출 상한선입니다. |
| availableBalance | 신용 한도를 포함하여 지출 가능한 금액입니다. |
| currentBalance | 신용 한도를 제외한 실제 지갑 잔액입니다. |
| externalId | PO 번호, Salesforce ID 등을 위한 선택적 필드입니다. |
| archived | 지갑이 보관(아카이브)되었는지 여부를 나타내는 불리언 플래그입니다. |
자주 묻는 질문과 문제 해결 방법은 다음을 참조하세요. [자주 묻는 질문](/retail-media-interface/partner/ko/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/ko/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.