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 ट्रैक करें

जब आप किसी ग्राहक का खाता बनाते हैं, तो उसे स्वचालित रूप से एक wallet मिल जाता है। Wallets में USD, EUR और GBP currencies के लिए अलग-अलग monetary balances का समर्थन होता है।

Customer Wallets ≠ Credit-Based BillingCustomer Wallets में वास्तविक monetary balances (USD, EUR, GBP) होते हैं, जिन्हें 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

Euros में balance (cents में संग्रहीत)

integer

Pounds Sterling में balance (pence में संग्रहीत)

वर्तमान में केवल USD, EUR और GBP balances उपलब्ध हैं। Native INR wallet बंद कर दिया गया है — Payout Structure देखें। UPI, RuPay और Indian-card subscriptions के लिए INR अभी भी transaction currency के रूप में समर्थित है।

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

Customer Balances की जाँच करें

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

Get Customer Wallet Balances

सभी समर्थित currencies में customer के wallet monetary balances की जाँच करें।

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

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

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 देखें

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

List Customer Wallet Ledger Entries

Customer के लिए हर monetary transaction देखें।

वास्तविक दुनिया के उदाहरण

Wallet में Refund

जब कोई customer refund का अनुरोध करता है, तो traditional card refund करने के बजाय आप राशि को उसके wallet balance में जोड़ सकते हैं। इससे funds आपके ecosystem में बने रहते हैं और future 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

नए customers को उनकी पहली purchase के लिए प्रोत्साहित करने हेतु 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 को कवर करने के लिए 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 करने के लिए prompt किया जा सके।

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 manage करें।

US Customers

US-based customers के लिए USD funds manage करें।

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}`
});

European Customers

Europe-based customers के लिए EUR funds manage करें।

await client.customers.wallets.ledgerEntries.create(customerId, {
  amount: 18000, // €180.00 in cents
  currency: 'EUR',
  entry_type: 'credit',
  reason: 'EUR account funding',
  idempotency_key: `eur_deposit_${paymentId}`
});

UK Customers

UK-based customers के लिए GBP funds manage करें।

await client.customers.wallets.ledgerEntries.create(customerId, {
  amount: 15000, // £150.00 in pence
  currency: 'GBP',
  entry_type: 'credit',
  reason: 'GBP account funding',
  idempotency_key: `gbp_deposit_${paymentId}`
});

Best Practices

Duplicate Transactions रोकें

यह सुनिश्चित करने के लिए idempotency keys का उपयोग करें कि एक ही event के लिए funds गलती से दो बार add या deduct न हों।

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
    });
    
    // Replaying the same idempotency_key returns the original entry rather than
    // creating a duplicate, so no special duplicate handling is required.
    return { success: true, wallet: result };
  } catch (error) {
    if (error.status === 400) {
      // e.g. insufficient balance on a debit
      return { success: false, reason: 'insufficient_balance' };
    }

    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 करें।

अंतिम संशोधन 6 अगस्त 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 की जाँच करें

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