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, EUR och GBP, med separata monetära saldon för varje valuta.

Kundplånböcker ≠ kreditbaserad faktureringKundplånböcker innehåller verkliga monetära saldon (USD, EUR, GBP) som kan användas för 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 euro (lagras i cent)

integer

Saldo i brittiska pund (lagras i pence)

För närvarande är endast saldon i USD, EUR och GBP tillgängliga. Den inhemska INR-plånboken har avvecklats – se Utbetalningsstruktur. INR stöds fortfarande som transaktionsvaluta för UPI-, RuPay- och indiska kortprenumerationer.

Arbeta med plånböcker

Kontrollera kundsaldon

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

Get Customer Wallet Balances

Kontrollera en kunds monetära saldon i plånboken för alla valutor som stöds.

Lägg till eller dra av pengar

Fyll på kunders plånböcker (till exempel välkomstbonusar eller återbetalningssaldon) eller dra av pengar (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 pengar i plånboken och 'debit' för att dra av pengar från plånboken.

Create Customer Wallet Ledger Entry

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

Visa transaktionshistorik

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

List Customer Wallet Ledger Entries

Visa varje monetär transaktion för en kund.

Exempel från verkligheten

Återbetalning till plånboken

När en kund begär en återbetalning kan du lägga till beloppet i plånbokssaldot i stället för att genomföra en traditionell kortåterbetalning. På så sätt stannar pengarna i 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 monetär 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ånboken

Dra av pengar 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 fylla på sina konton i förväg och använda saldot över tid.

Add Initial Funds

Lägg till pengar 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 kunderna börjar få ont om pengar 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 monetära saldon 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}`
});

European Customers

Hantera EUR-medel för kunder i Europa.

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

Hantera GBP-medel för kunder i Storbritannien.

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

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

Kontrollera saldon före debitering

Verifiera att kunderna har tillräckligt med pengar 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 händer härnäst

Dessa funktioner är planerade för framtida releaser:

Saldoexpiration: Ställ in att pengar ska förfalla efter en viss period
Bättre analys: Detaljerade rapporter över utgifter och saldotrender
Fler Webhooks: Realtidsaviseringar 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 pengar

Create Customer Wallet Ledger Entry

Visa transaktionshistorik

List Customer Wallet Ledger Entries

Exempel från verkligheten

Återbetalning till plånboken

Välkomstbonus / kampanjsaldo

Prenumerationsbetalning från plånboken

Förbetalt faktureringssystem

Stöd för flera valutor

Bästa praxis

Förhindra dubbla transaktioner

Kontrollera saldon före debitering

Vad händer 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 pengar

Create Customer Wallet Ledger Entry

​Visa transaktionshistorik

List Customer Wallet Ledger Entries

​Exempel från verkligheten

​Återbetalning till plånboken

​Välkomstbonus / kampanjsaldo

​Prenumerationsbetalning från plånboken

​Förbetalt faktureringssystem

​Stöd för flera valutor

​Bästa praxis

​Förhindra dubbla transaktioner

​Kontrollera saldon före debitering

​Vad händer 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 pengar

Visa transaktionshistorik

Exempel från verkligheten

Återbetalning till plånboken

Välkomstbonus / kampanjsaldo

Prenumerationsbetalning från plånboken

Förbetalt faktureringssystem

Stöd för flera valutor

Bästa praxis

Förhindra dubbla transaktioner

Kontrollera saldon före debitering

Vad händer härnäst