Skip to main content

Get Customer Wallets

Hämta en kunds saldo i varje valuta.

Create Ledger Entry

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

List Ledger Entries

Bläddra igenom alla plånbokstransaktioner.

Vad är kundplånböcker?

En kundplånbok innehåller riktiga pengar för en kund, med ett saldo per valuta. Använd plånböcker för att:
  • Lagra förbetalda medel för framtida prenumerationsbetalningar
  • Hantera återbetalningar som plånbokssaldo i stället för en återbetalning till kortet
  • Utfärda kampanjsaldon, till exempel välkomstbonusar eller lojalitetsbelöningar
  • Använda plånboksmedel för prenumerationsavgifter automatiskt vid debitering
  • Spåra varje transaktion i en bokföring med saldot före och efter
Du skapar inte plånböcker själv. En kunds plånbok för en valuta skapas med ett saldo på noll första gången du lägger till en bokföringspost i den valutan. Fram till dess returnerar Get Customer Wallets ingen post för den valutan.
Kundplånböcker ≠ kreditbaserad faktureringCustomer Wallets innehåller riktiga pengar som Dodo Payments använder för prenumerationsavgifter.Om du vill spåra virtuella användningsenheter som API-anrop, tokens eller beräkningstimmar använder du Credit-Based Billing i stället.
Customer Wallets

Så fungerar det

När en prenumeration förnyas eller en planändring skapar en avgift använder Dodo Payments först kundens plånbokssaldo i den valutan och debiterar sedan betalningsmetoden för resten. Om saldot endast täcker en del av avgiften betalar plånboken den delen.

Automatisk konfiguration

Du behöver inte konfigurera något. Lägg till en bokföringspost via API:t eller klicka på Apply Credit/Debit på kundens flik Wallets i instrumentpanelen, så är plånboken för den valutan klar att användas.

Stöd för flera valutor

Varje valuta har sitt eget saldo. Varje plånbok i svaret från Get Customer Wallets har en currency och en balance i den minsta valutaenheten, och svaret innehåller dessutom total_balance_usd, summan av alla saldon omräknade till USD. Bokföringsposter accepterar dessa valutor:
integer
Saldo i amerikanska dollar (lagras i cent)
integer
Saldo i euro (lagras i cent)
integer
Saldo i brittiska pund (lagras i pence)
Kundplånböcker innehåller saldon i USD, EUR och GBP. Den avvecklade inhemska INR-plånboken som beskrivs i Payout Structure är din utbetalningsplånbok som handlare, inte en kundplånbok. INR stöds fortfarande som transaktionsvaluta för UPI-, RuPay- och indiska kortprenumerationer.

Arbeta med plånböcker

Kontrollera kundsaldon

Hämta en kunds saldo i varje valuta, till exempel för att bekräfta saldot före ett köp eller visa det i din app.

Get Customer Wallet Balances

Hämta en kunds plånbokssaldon i alla valutor.

Lägg till eller dra av pengar

Lägg till medel, till exempel en välkomstbonus eller ett återbetalningssaldo, eller dra av medel, till exempel en manuell debitering. entry_type, currency och amount krävs. amount är ett positivt heltal i den minsta valutaenheten. Lägg till en reason (högst 500 tecken) i ditt granskningsspår samt en idempotency_key för att förhindra dubbletter. Svaret är den uppdaterade plånboken.
entry_type är 'credit' för att lägga till medel i plånboken och 'debit' för att dra av medel från den. En debitering som överstiger saldot misslyckas med 400.

Create Customer Wallet Ledger Entry

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

Visa transaktionshistorik

Lista alla krediter och debiteringar för en kund, med sidindelning och ett valfritt currency-filter. Varje post har en event_type (payment, payment_reversal, refund, refund_reversal, dispute, dispute_reversal eller merchant_adjustment), amount samt before_balance och after_balance. Använd bokföringen för att stämma av konton och besvara kundfrågor.

List Customer Wallet Ledger Entries

Lista alla plånbokstransaktioner för en kund.

Exempel från verkligheten

Exemplen använder TypeScript SDK. client är en DodoPayments-klient som skapas enligt Integration Guide.

Återbetalning till plånbok

Om du vill återbetala en kund som plånbokssaldo i stället för till kortet lägger du till beloppet med en kreditpost. Medlen stannar hos ditt företag för kundens nästa köp.
En kreditpost i bokföringen återbetalar inte den ursprungliga betalningen. När du återbetalar en betalning via Refunds API återför Dodo Payments automatiskt den del av betalningen som plånboken betalade till plånboken.

Välkomstbonus / kampanjsaldo

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

Prenumerationsbetalning från plånbok

Dra av medel från en plånbok för att betala en avgift som du debiterar själv. Förnyelser kräver inte detta steg eftersom Dodo Payments automatiskt använder saldot för dem.

Förbetalt faktureringssystem

Låt kunder finansiera sina konton i förväg och använda saldot över tid. customerId, paymentId och purchaseId är dina egna identifierare för kunden, insättningen och köpet.
1

Add Initial Funds

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

Apply Balance to Purchases

Dra av från saldot när kunden använder dina tjänster.
3

Monitor Balances

Kontrollera om en kund börjar få slut på medel och uppmana kunden att fylla på.

Stöd för flera valutor

Ha separata saldon för kunder i olika regioner.
Hantera USD-medel för kunder i USA.
Hantera EUR-medel för kunder i Europa.
Hantera GBP-medel för kunder i Storbritannien.

Bästa praxis

Förhindra dubbla transaktioner

Skicka en idempotency_key som härleds från händelsen som orsakade posten, till exempel ett order- eller betalnings-ID, så att ett nytt försök inte lägger till eller drar av medlen två gånger. Om du upprepar en begäran med samma nyckel skapar Dodo Payments ingen ny post utan returnerar den aktuella plånboken.

Kontrollera saldon före debitering

Innan du drar av ett stort belopp från en plånbok bör du bekräfta att saldot täcker beloppet.

Vad kommer härnäst

Kundplånböcker stöder inte dessa funktioner:
  • Saldoexpirering: Plånboksmedel förfaller inte.
  • Analys: Det finns inga rapporter om utgifter eller saldotrender. Använd bokföringen för att skapa egna.
  • Webhooks: Ingen webhook utlöses när ett saldo ändras, och det finns inga aviseringar om lågt saldo. Lista bokföringsposterna om du vill spåra ändringar.
Börja med grundläggande insättningar och avdrag och automatisera sedan mer av ditt faktureringsarbetsflöde när företaget växer.
Senast ändrad 26 september 2026