Customer Wallets

Get Customer Wallets

सभी currencies में customer के monetary balances देखें।

Create Ledger Entry

customer wallets में funds जोड़ें या घटाएँ।

List Ledger Entries

pagination के साथ पूरी transaction history देखें।

Customer Wallets क्या हैं?

Customer wallets monetary balance accounts होते हैं, जिनमें आपके users के लिए वास्तविक funds रखे जाते हैं। उनका account बनाते ही हर customer को एक wallet अपने-आप मिल जाता है। आप इन wallets का उपयोग निम्नलिखित के लिए कर सकते हैं:

भविष्य के subscription payments के लिए prepaid funds स्टोर करें
card refunds के बजाय wallet balance के रूप में refunds संभालें
welcome bonuses या loyalty rewards जैसे promotional balances जारी करें
billing के दौरान wallet funds को invoices में अपने-आप लागू करें
विस्तृत ledger history के साथ monetary transactions ट्रैक करें

जब आप customer का account बनाते हैं, तो हर customer को अपने-आप एक wallet मिलता है। Wallets USD और INR currencies को support करते हैं और प्रत्येक के लिए अलग monetary balances रखते हैं।

Customer Wallets ≠ Credit-Based BillingCustomer Wallets में वास्तविक monetary balances (USD, INR) रखे जाते हैं, जिन्हें invoices और subscription payments में लागू किया जा सकता है।यदि आप virtual usage units (API calls, tokens, compute hours) को ट्रैक करना चाहते हैं, तो इसके बजाय Credit-Based Billing देखें।

यह कैसे काम करता है

Customer wallets में funds रखे जाते हैं, जिन्हें customers अपनी purchases पर लागू कर सकते हैं। जब किसी customer के पास invoice या recurring subscription charge होता है, तो पहले उसका wallet balance जाँचा जाता है। उपलब्ध funds को primary payment method से charge करने से पहले invoice पर अपने-आप लागू कर दिया जाता है।

Automatic Setup

जब आप नया customer बनाते हैं, तो Dodo Payments अपने-आप zero balance वाला wallet बनाता है। यह हमारे API के माध्यम से तुरंत funds प्राप्त करने के लिए तैयार होता है।

Multi-Currency Support

प्रत्येक wallet अलग-अलग currencies में balances रख सकता है:

integer

US Dollars में balance (cents में स्टोर किया जाता है)

integer

Indian Rupees में balance (paise में स्टोर किया जाता है)

वर्तमान में केवल USD और INR balances उपलब्ध हैं। जल्द ही और currencies उपलब्ध होंगी।

Wallets के साथ काम करना

Customer Balances जाँचें

देखें कि customer के पास सभी currencies में कितने funds हैं। Purchase process करने से पहले उपलब्ध balance सत्यापित करने या अपने application UI में balance दिखाने के लिए यह उपयोगी है।

Get Customer Wallet Balances

सभी supported currencies में customer के wallet monetary balances जाँचें।

Funds जोड़ें या घटाएँ

Customer wallets में funds जोड़ें (जैसे welcome bonuses या refund balances) या funds घटाएँ (जैसे subscription charges)। स्पष्ट audit trail बनाए रखने के लिए आप प्रत्येक transaction का reason दे सकते हैं।

The entry_type field uses 'credit' to add funds to the wallet and 'debit' to subtract funds from the wallet.

Create Customer Wallet Ledger Entry

Customer के wallet में funds जोड़ें या घटाएँ।

Transaction History देखें

Customer के प्रत्येक credit और debit transaction को देखें। यह विस्तृत ledger आपको accounts का मिलान करने में मदद करता है और customers के लिए transparency प्रदान करता है।

List Customer Wallet Ledger Entries

Customer का प्रत्येक monetary transaction देखें।

वास्तविक उदाहरण

Wallet में Refund

जब कोई customer refund का अनुरोध करता है, तो traditional card refund करने के बजाय आप राशि को उसके wallet balance में जोड़ सकते हैं। इससे funds आपके ecosystem में भविष्य की purchases के लिए बने रहते हैं।

async function refundToWallet(customerId, refundAmount, originalPaymentId) {
  await client.customers.wallets.ledgerEntries.create(customerId, {
    amount: refundAmount, // Amount in cents
    currency: 'USD',
    entry_type: 'credit',
    reason: `Refund for payment ${originalPaymentId}`,
    idempotency_key: `refund_${originalPaymentId}`
  });
}

Welcome Bonus / Promotional Balance

नई purchase को प्रोत्साहित करने के लिए नए customers को monetary welcome bonus दें।

async function addWelcomeBonus(customerId) {
  await client.customers.wallets.ledgerEntries.create(customerId, {
    amount: 1000, // $10.00 promotional balance
    currency: 'USD',
    entry_type: 'credit',
    reason: 'Welcome bonus - $10 promotional balance',
    idempotency_key: `welcome_${customerId}`
  });
}

Wallet से Subscription Payment

Subscription charge या manual purchase को cover करने के लिए wallet से funds घटाएँ।

async function deductForPurchase(customerId, purchaseAmount, purchaseId) {
  try {
    await client.customers.wallets.ledgerEntries.create(customerId, {
      amount: purchaseAmount,
      currency: 'USD',
      entry_type: 'debit',
      reason: `Subscription charge - monthly billing`,
      idempotency_key: `charge_${purchaseId}`
    });
  } catch (error) {
    if (error.status === 400) {
      console.log('Insufficient wallet balance');
    }
  }
}

Prepaid Billing System

Customers को अपने accounts में पहले से funds जोड़ने दें और समय के साथ उस balance से राशि घटाएँ।

Add Initial Funds

जब customer deposit करता है, तो उसके wallet में funds जोड़ें।

await client.customers.wallets.ledgerEntries.create(customerId, {
  amount: 5000, // $50.00 deposit
  currency: 'USD',
  entry_type: 'credit',
  reason: 'Account funding - prepaid deposit',
  idempotency_key: `deposit_${paymentId}`
});

Apply Balance to Purchases

Customer द्वारा आपकी services का उपयोग करने या subscriptions renew करने पर balance से राशि घटाएँ।

await client.customers.wallets.ledgerEntries.create(customerId, {
  amount: 1500, // $15.00 charge
  currency: 'USD', 
  entry_type: 'debit',
  reason: 'Service purchase - monthly subscription',
  idempotency_key: `purchase_${purchaseId}`
});

Monitor Balances

Customers के funds कम होने पर top-up का संकेत देने के लिए जाँच करें।

const wallets = await client.customers.wallets.list(customerId);
const usdWallet = wallets.items.find(w => w.currency === 'USD');
const balance = usdWallet.balance;

if (balance < 1000) { // Less than $10.00
  // Send low balance notification
  await sendLowBalanceNotification(customerId, balance);
}

Multi-Currency Support

अलग-अलग regions में customers के लिए अलग monetary balances प्रबंधित करें।

US Customers

US-based customers के लिए USD funds प्रबंधित करें।

await client.customers.wallets.ledgerEntries.create(customerId, {
  amount: 20000, // $200.00 in cents
  currency: 'USD',
  entry_type: 'credit',
  reason: 'USD account funding',
  idempotency_key: `usd_deposit_${paymentId}`
});

Indian Customers

Indian customers के लिए INR funds प्रबंधित करें।

await client.customers.wallets.ledgerEntries.create(customerId, {
  amount: 1500000, // Rs 15,000 in paise
  currency: 'INR',
  entry_type: 'credit',
  reason: 'INR account funding',
  idempotency_key: `inr_deposit_${paymentId}`
});

Best Practices

Duplicate Transactions रोकें

यह सुनिश्चित करने के लिए idempotency keys का उपयोग करें कि आप गलती से एक ही event के लिए funds दो बार न जोड़ें या घटाएँ।

async function addFundsSafely(customerId, amount, reason) {
  const idempotencyKey = `${reason}_${customerId}_${Date.now()}`;
  
  try {
    const result = await client.customers.wallets.ledgerEntries.create(customerId, {
      amount: amount,
      currency: 'USD',
      entry_type: 'credit',
      reason: reason,
      idempotency_key: idempotencyKey
    });
    
    return { success: true, wallet: result };
  } catch (error) {
    if (error.status === 409) {
      // Transaction already processed
      return { success: true, wallet: null, duplicate: true };
    }
    
    throw error;
  }
}

Charging से पहले Balances जाँचें

Wallet से बड़ी transactions process करने का प्रयास करने से पहले सत्यापित करें कि customers के पास पर्याप्त funds हैं।

async function checkBalanceBeforeOperation(customerId, requiredAmount) {
  const wallets = await client.customers.wallets.list(customerId);
  const usdWallet = wallets.items.find(w => w.currency === 'USD');
  
  if (!usdWallet || usdWallet.balance < requiredAmount) {
    throw new Error('Insufficient funds for this operation');
  }
  
  return usdWallet.balance;
}

आगे क्या आ रहा है

इन features को future releases के लिए planned किया गया है:

Balance Expiration: एक निश्चित अवधि के बाद funds को expire होने के लिए सेट करें
Better Analytics: विस्तृत spending reports और balance trends
More Webhooks: balance changes और low balance alerts के लिए real-time notifications

Basic funding और deduction operations से शुरुआत करें, फिर अपने business के बढ़ने के साथ अधिक complex automated billing workflows को integrate करें।

अंतिम संशोधन 31 जुलाई 2026

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Get Customer Wallets

Create Ledger Entry

List Ledger Entries

Customer Wallets क्या हैं?

यह कैसे काम करता है

Automatic Setup

Multi-Currency Support

Wallets के साथ काम करना

Customer Balances जाँचें

Get Customer Wallet Balances

Funds जोड़ें या घटाएँ

Create Customer Wallet Ledger Entry

Transaction History देखें

List Customer Wallet Ledger Entries

वास्तविक उदाहरण

Wallet में Refund

Welcome Bonus / Promotional Balance

Wallet से Subscription Payment

Prepaid Billing System

Multi-Currency Support

Best Practices

Duplicate Transactions रोकें

Charging से पहले Balances जाँचें

आगे क्या आ रहा है

Get Customer Wallets

Create Ledger Entry

List Ledger Entries

​Customer Wallets क्या हैं?

​यह कैसे काम करता है

​Automatic Setup

​Multi-Currency Support

​Wallets के साथ काम करना

​Customer Balances जाँचें

Get Customer Wallet Balances

​Funds जोड़ें या घटाएँ

Create Customer Wallet Ledger Entry

​Transaction History देखें

List Customer Wallet Ledger Entries

​वास्तविक उदाहरण

​Wallet में Refund

​Welcome Bonus / Promotional Balance

​Wallet से Subscription Payment

​Prepaid Billing System

​Multi-Currency Support

​Best Practices

​Duplicate Transactions रोकें

​Charging से पहले Balances जाँचें

​आगे क्या आ रहा है

Customer Wallets क्या हैं?

यह कैसे काम करता है

Automatic Setup

Multi-Currency Support

Wallets के साथ काम करना

Customer Balances जाँचें

Funds जोड़ें या घटाएँ

Transaction History देखें

वास्तविक उदाहरण

Wallet में Refund

Welcome Bonus / Promotional Balance

Wallet से Subscription Payment

Prepaid Billing System

Multi-Currency Support

Best Practices

Duplicate Transactions रोकें

Charging से पहले Balances जाँचें

आगे क्या आ रहा है