Kundplånböcker

Get Customer Wallets

Kontrollera kunders penningbelopp i olika valutor.

Create Ledger Entry

Lägg till eller dra av medel från kundplånböcker.

List Ledger Entries

Visa fullständig transaktionshistorik med paginering.

Vad är kundplånböcker?

Kundplånböcker är konton för penningbelopp som innehåller riktiga medel för dina användare. Varje kund får automatiskt en när du skapar deras konto. Du kan använda dessa plånböcker för att:

Lagra förbetalda medel för framtida prenumerationsbetalningar
Hantera återbetalningar som plånbokssaldo i stället för kortåterbetalningar
Utfärda kampanjsaldon som välkomstbonusar eller lojalitetsbelöningar
Tillämpa plånboksmedel på fakturor automatiskt under faktureringen
Följa penningtransaktioner med en detaljerad reskontrahistorik

Varje kund får automatiskt en plånbok när du skapar deras konto. Plånböcker stöder valutorna USD och INR, med separata penningbelopp för varje valuta.

Kundplånböcker ≠ kreditbaserad faktureringKundplånböcker innehåller riktiga penningbelopp (USD, INR) som kan tillämpas på fakturor och prenumerationsbetalningar.Om du vill följa virtuella användningsenheter (API-anrop, tokens, beräkningstimmar) kan du läsa mer om kreditbaserad fakturering i stället.

Så fungerar det

Kundplånböcker innehåller medel som kunder kan använda för sina köp. När en kund har en faktura eller en återkommande prenumerationsdebitering kontrolleras plånbokssaldot först. Alla tillgängliga medel tillämpas automatiskt på fakturan innan kundens primära betalningsmetod debiteras.

Automatisk konfiguration

När du skapar en ny kund skapar Dodo Payments automatiskt en plånbok med nollsaldo. Den är redo att ta emot medel direkt via vårt API.

Stöd för flera valutor

Varje plånbok kan innehålla saldon i olika valutor:

integer

Saldo i amerikanska dollar (lagras i cent)

integer

Saldo i indiska rupier (lagras i paise)

För närvarande är endast saldon i USD och INR tillgängliga. Fler valutor kommer snart.

Arbeta med plånböcker

Kontrollera kundsaldon

Se hur mycket medel en kund har i alla valutor. Detta är användbart för att verifiera det tillgängliga saldot innan ett köp behandlas eller för att visa saldot i användargränssnittet i din applikation.

Get Customer Wallet Balances

Kontrollera en kunds penningbelopp i plånboken i alla valutor som stöds.

Lägg till eller dra av medel

Finansiera kundplånböcker (till exempel med välkomstbonusar eller återbetalningssaldon) eller dra av medel (till exempel prenumerationsavgifter). Du kan ange orsaker för varje transaktion för att upprätthålla ett tydligt revisionsspår.

Fältet entry_type använder 'credit' för att lägga till medel i plånboken och 'debit' för att dra av medel från plånboken.

Create Customer Wallet Ledger Entry

Lägg till eller dra av medel från en kunds plånbok.

Visa transaktionshistorik

Se varje kredit- och debettransaktion för en kund. Denna detaljerade reskontra hjälper dig att stämma av konton och ger dina kunder insyn.

List Customer Wallet Ledger Entries

Visa varje penningtransaktion för en kund.

Exempel från verkligheten

Återbetalning till plånbok

När en kund begär en återbetalning kan du lägga till beloppet i deras plånbokssaldo i stället för att genomföra en traditionell kortåterbetalning. Detta håller medlen inom ditt ekosystem för framtida köp.

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

Välkomstbonus / kampanjsaldo

Ge nya kunder en penningbaserad välkomstbonus för att uppmuntra deras första köp.

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

Prenumerationsbetalning från plånbok

Dra av medel från en plånbok för att täcka en prenumerationsavgift eller ett manuellt köp.

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

Förbetalt faktureringssystem

Låt kunder finansiera sina konton i förväg och använda saldot över tid.

Add Initial Funds

Lägg till medel i kundens plånbok när de gör en insättning.

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

Dra av från saldot när kunden använder dina tjänster eller förnyar prenumerationer.

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

Kontrollera om kunder börjar få slut på medel för att uppmana dem att fylla på saldot.

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

Stöd för flera valutor

Hantera separata penningbelopp för kunder i olika regioner.

US Customers

Hantera USD-medel för kunder i USA.

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

Hantera INR-medel för indiska kunder.

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

Bästa praxis

Förhindra dubbla transaktioner

Använd idempotency keys för att säkerställa att du inte råkar lägga till eller dra av medel två gånger för samma händelse.

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

Kontrollera saldon före debitering

Verifiera att kunderna har tillräckliga medel innan du försöker behandla stora transaktioner från plånboken.

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

Vad kommer härnäst

Dessa funktioner planeras för framtida versioner:

Saldoexpiration: Ställ in att medel ska förfalla efter en viss period
Bättre analys: Detaljerade rapporter över utgifter och saldotrender
Fler Webhooks: Aviseringar i realtid om saldoändringar och varningar vid lågt saldo

Börja med grundläggande insättnings- och avdragsoperationer och integrera sedan mer komplexa automatiserade faktureringsflöden i takt med att ditt företag växer.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Get Customer Wallets

Create Ledger Entry

List Ledger Entries

Vad är kundplånböcker?

Så fungerar det

Automatisk konfiguration

Stöd för flera valutor

Arbeta med plånböcker

Kontrollera kundsaldon

Get Customer Wallet Balances

Lägg till eller dra av medel

Create Customer Wallet Ledger Entry

Visa transaktionshistorik

List Customer Wallet Ledger Entries

Exempel från verkligheten

Återbetalning till plånbok

Välkomstbonus / kampanjsaldo

Prenumerationsbetalning från plånbok

Förbetalt faktureringssystem

Stöd för flera valutor

Bästa praxis

Förhindra dubbla transaktioner

Kontrollera saldon före debitering

Vad kommer härnäst

Get Customer Wallets

Create Ledger Entry

List Ledger Entries

​Vad är kundplånböcker?

​Så fungerar det

​Automatisk konfiguration

​Stöd för flera valutor

​Arbeta med plånböcker

​Kontrollera kundsaldon

Get Customer Wallet Balances

​Lägg till eller dra av medel

Create Customer Wallet Ledger Entry

​Visa transaktionshistorik

List Customer Wallet Ledger Entries

​Exempel från verkligheten

​Återbetalning till plånbok

​Välkomstbonus / kampanjsaldo

​Prenumerationsbetalning från plånbok

​Förbetalt faktureringssystem

​Stöd för flera valutor

​Bästa praxis

​Förhindra dubbla transaktioner

​Kontrollera saldon före debitering

​Vad kommer härnäst

Vad är kundplånböcker?

Så fungerar det

Automatisk konfiguration

Stöd för flera valutor

Arbeta med plånböcker

Kontrollera kundsaldon

Lägg till eller dra av medel

Visa transaktionshistorik

Exempel från verkligheten

Återbetalning till plånbok

Välkomstbonus / kampanjsaldo

Prenumerationsbetalning från plånbok

Förbetalt faktureringssystem

Stöd för flera valutor

Bästa praxis

Förhindra dubbla transaktioner

Kontrollera saldon före debitering

Vad kommer härnäst