Get Customer Wallets
통화별 고객 금전 잔액을 확인합니다.
Create Ledger Entry
고객 지갑에 자금을 추가하거나 차감합니다.
List Ledger Entries
페이지네이션을 사용해 전체 거래 내역을 확인합니다.
고객 지갑이란?
고객 지갑은 사용자를 위한 실제 자금을 보관하는 금전 잔액 계정입니다. 고객 계정을 생성하면 모든 고객에게 지갑이 자동으로 생성됩니다. 다음과 같은 용도로 지갑을 사용할 수 있습니다:- 향후 구독 결제를 위한 선불 자금 보관
- 카드 환불 대신 지갑 잔액으로 환불 처리
- 가입 보너스나 로열티 보상과 같은 프로모션 잔액 지급
- 청구 중 지갑 자금을 청구서에 자동 적용
- 상세 원장 내역으로 금전 거래 추적
고객 계정을 생성하면 모든 고객에게 자동으로 wallet이 생성됩니다. wallet은 USD, EUR, GBP 통화를 지원하며 각 통화에 대해 별도의 금전 잔액을 보유합니다.

작동 방식
고객 지갑에는 고객이 구매에 사용할 수 있는 자금이 보관됩니다. 고객에게 청구서나 반복 구독 요금이 발생하면 먼저 지갑 잔액을 확인합니다. 사용 가능한 자금이 있으면 기본 결제 수단으로 청구하기 전에 해당 자금이 청구서에 자동으로 적용됩니다.자동 설정
새 고객을 생성하면 Dodo Payments 자동으로 잔액이 0인 지갑을 생성합니다. 지갑은 API를 통해 즉시 자금을 받을 수 있는 상태가 됩니다.다중 통화 지원
각 지갑은 여러 통화의 잔액을 보관할 수 있습니다:integer
미국 달러 잔액(센트 단위로 저장)
integer
유로 잔액(센트 단위로 저장됨)
integer
파운드 스털링 잔액(펜스 단위로 저장됨)
현재 USD, EUR, GBP 잔액만 사용할 수 있습니다. INR native wallet은 중단되었습니다. 자세한 내용은 Payout Structure를 참조하세요. INR은 UPI, RuPay 및 인도 카드 구독의 거래 통화로 계속 지원됩니다.
Wallet 사용
고객 잔액 확인
모든 통화에 걸쳐 고객이 보유한 자금을 확인할 수 있습니다. 구매를 처리하기 전에 사용 가능한 잔액을 확인하거나 애플리케이션 UI에 잔액을 표시할 때 유용합니다.Get Customer Wallet Balances
지원되는 모든 통화로 고객 wallet의 금전 잔액을 확인합니다.
자금 추가 또는 차감
고객 wallet에 자금을 충전하거나(환영 보너스 또는 환불 잔액 등) 자금을 차감할 수 있습니다(구독 요금 등). 각 거래에 사유를 입력하여 명확한 감사 추적 기록을 유지할 수 있습니다.The
entry_type 필드는 'credit'를 사용하여 wallet에 자금을 추가하고 'debit'를 사용하여 wallet에서 자금을 차감합니다.Create Customer Wallet Ledger Entry
고객 wallet에서 자금을 추가하거나 차감합니다.
거래 내역 보기
고객의 모든 입금 및 출금 거래를 확인할 수 있습니다. 이 상세 원장은 계정을 대조하는 데 도움이 되며 고객에게 투명성을 제공합니다.List Customer Wallet Ledger Entries
고객의 모든 금전 거래를 확인합니다.
실제 사용 사례
Wallet으로 환불
고객이 환불을 요청하면 기존의 카드 환불을 처리하는 대신 해당 금액을 wallet 잔액에 추가할 수 있습니다. 이렇게 하면 자금이 생태계 내에 유지되어 향후 구매에 사용할 수 있습니다.환영 보너스 / 프로모션 잔액
신규 고객에게 금전적 환영 보너스를 제공하여 첫 구매를 유도할 수 있습니다.Wallet에서 구독 결제
구독 요금 또는 수동 구매를 처리하기 위해 wallet에서 자금을 차감합니다.선불 결제 시스템
고객이 계정에 미리 자금을 충전하고 시간이 지남에 따라 해당 잔액을 사용하도록 할 수 있습니다.1
Add Initial Funds
고객이 입금하면 고객 wallet에 자금을 추가합니다.
2
Apply Balance to Purchases
고객이 서비스를 이용하거나 구독을 갱신하면 잔액에서 자금을 차감합니다.
3
Monitor Balances
고객의 자금이 부족해지고 있는지 확인하여 충전을 안내합니다.
다중 통화 지원
서로 다른 지역의 고객을 위해 별도의 금전 잔액을 관리합니다.US Customers
US Customers
미국 고객의 USD 자금을 관리합니다.
European Customers
European Customers
유럽 고객의 EUR 자금을 관리합니다.
UK Customers
UK Customers
영국 고객의 GBP 자금을 관리합니다.
모범 사례
중복 거래 방지
idempotency key를 사용하여 동일한 이벤트에 대해 실수로 자금을 두 번 추가하거나 차감하지 않도록 합니다.청구 전 잔액 확인
wallet에서 대규모 거래를 처리하기 전에 고객에게 충분한 자금이 있는지 확인합니다.다음 단계
- 잔액 만료: 일정 기간 후 자금이 만료되도록 설정
- 향상된 분석: 상세한 지출 보고서 및 잔액 추이
- 추가 Webhooks: 잔액 변경 및 잔액 부족 알림에 대한 실시간 알림