Kundportal - Dodo Payments Documentation

Kundportalen är ett säkert, värdbaserat område där dina kunder kan hantera prenumerationer, se fakturor och få tillgång till licensnyckelinformation – utan att kontakta support.

Create Portal Session (API)

Skapa programmatiskt säkra, tidsbegränsade portal-sessioner.

Subscriptions

Hantera återkommande planer, uppgraderingar, nedgraderingar och tillägg.

Omgjord kundportal som visar aktiva prenumerationer, betalningsmetoder och faktureringshistorik

Vad är kundportalen?

Portalen erbjuder en pålitlig, varumärkesanpassad självbetjäningsupplevelse för kunder att:

Åtkomst till faktureringshistorik: Visa fakturor och ladda ner kvitton.
Hantera prenumerationer: Visa prenumerationsuppgifter, pausa och återuppta prenumerationer samt avsluta prenumerationer omedelbart eller vid nästa faktureringsdatum.
Uppdatera betalningsmetoder: Ändra betalningsmetoder för aktiva prenumerationer eller återaktivera pausade prenumerationer.
Hämta licensnycklar: Få åtkomst till alla nycklar som är kopplade till köp.
Navigera enkelt: Använd bakåtknappen för att gå mellan portalens avsnitt utan att förlora sammanhanget.

Nyckelfördelar

Mindre supportvolym: Kunder löser vanliga faktureringsfrågor på egen hand
Snabbare tid till värde: Omedelbar tillgång till fakturor och nycklar
Minskad risk för avhopp: Tydlig insyn i förnyelser och planinformation
Säker av design: Tokeniserad åtkomst med utgående länkar

Åtkomstmetoder

Kunder kan nå portalen antingen via en statisk länk eller en engångsdynamisk länk.

Statisk länk (e-postbaserad åtkomst)

Kunder kan begära åtkomst till portalen genom att ange sin e-postadress på en statisk länk som aldrig går ut. Formatet för den statiska portal-länken varierar beroende på miljö: Testläge (för test och utveckling):

https://test.customer.dodopayments.com/login/{business_id}

Live-läge (för produktion med riktiga transaktioner):

https://customer.dodopayments.com/login/{business_id}

Byt ut {business_id} mot din faktiska företagsidentifierare och dela sedan rätt länk med kunderna så att de kan ange sin e-post och få säker åtkomst till portalen.

Merchant flow

Gå till Försäljning → Kund.
Klicka på Dela inbjudan.
Kopiera Statisk länk och dela den med din kund.

Customer flow

Öppna den statiska länken.
Ange den e-post som användes vid köpet.
Ta emot en säker inloggningslänk för att komma åt portalen.

Befintliga kunder känner igen automatiskt.

Dynamisk länk (magisk länk)

En personlig, engångsmagisk länk som skickar kunder direkt till portalen. Länken går ut efter 24 timmar.

Dynamiska länkar upphör efter 24 timmar. Om den löper ut, skapa och skicka en ny länk.

Merchant flow

Gå till Försäljning → Kund.
Klicka på Dela inbjudan.
Kopiera Dynamisk länk och dela den med din kund.

Customer flow

Öppna den dynamiska länken.
Gå direkt in i Kundportalen utan att ange e-post.

Portalens funktioner

Den omarbetade kundportalen erbjuder ett rent, enhetligt gränssnitt med en vänsterställd sidopanel och organiserade sektioner för alla kontohanteringsbehov.

Active Subscriptions

Visa alla aktiva prenumerationer med planens namn, pris, förnyelsedatum och giltighet. Klicka på “Manage subscription” för att visa uppgifter, redigera faktureringsinformation, pausa eller avsluta.

Payment Methods

Visa alla sparade betalningsmetoder (kort, UPI osv.) med en överblick. Redigera betalningsmetoder direkt från prenumerationsdetaljerna.

Billing History

Visa alla transaktioner i en detaljerad tabell med datum, status, prisningstyp, rättigheter och nedladdningsbara fakturor.

Billing Information

Visa och redigera ditt namn, e-post, telefonnummer och faktureringsadress från prenumerationsdetaljsidan.

Portalöversikt

Huvudsidan i portalen visar alla aktiva prenumerationer, sparade betalningsmetoder och faktureringshistorik i en enda rullbar vy.

Huvudsidan i kundportalen visar aktiva prenumerationer och betalningsmetoder

Betalningsmetoder och faktureringshistorik

Scrolla nedåt för att se sparade betalningsmetoder och en komplett faktureringshistorik med statusindikatorer och nedladdningsbara fakturor.

Planändringar (uppgradering/nedgradering)

När produkter är organiserade i produktkollektioner kan kunder uppgradera eller nedgradera mellan planer direkt från Kundportalen.

Vill du aktivera uppgradering/nedgradering för befintliga prenumerationer? Lägg till dina prenumerationsprodukter i en produktkollektion. När de är grupperade kan kunder växla mellan planer i samma kollektion via Kundportalen.

Automatisk detektion: Vid första besöket upptäcker portalen kundens föredragna språk från deras webbläsarinställningar och laddar den matchande översättningen om den finns tillgänglig. Engelska används som reservspråk.
Manuell åsidosättning: Kunder kan när som helst ändra det aktiva språket från språkvalet i portalens header (tillgängligt både på skrivbordet och mobilen).
Sparad preferens: Det valda språket lagras i NEXT_LOCALE cookie (giltigt i 1 år) så att portalen minns valet över sessioner.

Åtgärd	Beskrivning	När tillgänglig
Uppgradera	Byt till en plan i högre nivå inom samma kollektion	Företaget har aktiverat prenumerationsuppdateringar
Nedgradera	Byt till en plan i lägre nivå inom samma kollektion	Företaget har aktiverat prenumerationsuppdateringar

Hur planändringar fungerar

Kund ser sin aktuella prenumeration i portalen
Tillgängliga uppgraderings-/nedgraderingsalternativ visas baserat på produktkollektionen
Kunden väljer den nya planen
Pro rata beräknas och betalning behandlas omedelbart (om tillämpligt)
Prenumerationen uppdateras till den nya planen

Planändringar är endast tillgängliga mellan produkter inom samma kollektion. Produkterna måste ha prenumerations- eller användningsbaserade faktureringstyper.

Företagskontroller

Företag kan konfigurera hur planändringar ska fungera i Prenumerationsinställningar:

Tillåt prenumerationsuppdateringar: Aktivera eller inaktivera möjligheten för kunder att uppgradera eller nedgradera sina prenumerationer

Product Collections

Lär dig hur du skapar produktkollektioner och konfigurerar uppgraderings-/nedgraderingsvägar.

Kunden klickar på Change Plan på sidan med prenumerationsdetaljer.
Tillgängliga alternativ för upp- eller nedgradering visas baserat på produktsamlingen.
Kunden väljer den nya planen. Panelen Confirm Plan Change visar den aktuella respektive uppdaterade planen, en uppdelning per rad (kredit för den gamla planen, debitering för den nya), skatt och beloppet som ska betalas nu. Kunder kan även lägga till en rabattkod här.
Kunden bekräftar med Pay ${amount}.
Proratering beräknas och debiteringen behandlas — antingen mot den sparade betalningsmetoden eller via en värdbaserad kassasida om företaget samlar in betalningar för planändringar via payment link (se nedan).
Prenumerationen uppdateras till den nya planen. Om det sker direkt eller först efter att debiteringen har gått igenom beror på er hantering av misslyckade betalningar; en planändring som betalas via payment link väntar alltid på betalningen.

Subscription details page with Change Plan, Pause Subscription, and Cancel Subscription buttons

Confirm Plan Change panel showing current vs. updated plan, a line-item breakdown, discount code entry, and the Pay button

Planändringar är endast tillgängliga mellan produkter inom samma samling. Produkterna måste ha prenumerationsbaserad eller användningsbaserad fakturering.

Samla in betalningar för planändringar via payment link

Som standard debiteras kundens sparade betalningsmetod direkt vid en omedelbar planändring. Om du aktiverar Collect Plan Change Payments by Payment Link ändras detta: i stället för att debitera det sparade kortet skickas kunden till en Dodo Checkout-sida för att betala. Detta gäller både uppgraderingar och nedgraderingar som resulterar i en debitering.

Settings → Subscriptions page with the Collect Plan Change Payments by Payment Link toggle enabled and its tooltip explaining the behavior

Hosted Dodo Checkout page from a separate example, where the customer pays for a plan change

Prenumerationen ligger kvar på sin aktuella plan tills betalningen i kassan har genomförts — en misslyckad eller avbruten betalning lämnar prenumerationen oförändrad, så kunden kan försöka igen i samma kassasession. Schemalagda nedgraderingar (effective_at: next_billing_date) påverkas inte och fortsätter att tillämpas på nästa faktureringsdatum utan att gå via kassan.

Detta gäller endast omedelbara planändringar. Om kunden redan har en väntande payment link för en planändring avvisas ytterligare en begäran om planändring tills länken har betalats eller löpt ut.

Plan Change via Payment Link (API)

Så begär du en payment link med collect_via_payment_link och hanterar svaret.

Företagsinställningar

Företag kan konfigurera prenumerationsbeteendet i portalen under Subscription Settings:

Allow Subscription Updates: Aktivera eller inaktivera möjligheten för kunder att uppgradera eller nedgradera sina prenumerationer
Allow Subscription Cancellation: Aktivera eller inaktivera möjligheten för kunder att själva avsluta sina prenumerationer
Allow Subscription Pause: Aktivera eller inaktivera möjligheten för kunder att pausa och återuppta sina egna prenumerationer
Collect Plan Change Payments by Payment Link: Skicka kunder till en kassasida för att betala för en omedelbar planändring i stället för att debitera deras sparade betalningsmetod. Inaktiverat som standard.

Product Collections

Läs mer om hur du konfigurerar produktsamlingar och ställer in vägar för upp- och nedgradering.

Prenumerationsdetaljer

När kunder klickar på “Manage subscription” för en aktiv prenumeration kommer de till sidan med prenumerationsdetaljer. Den här sidan visar:

Plandetaljer: Prenumerationens namn, pris, förnyelsedatum och giltighetsperiod
Betalningsmetod: Kortet eller betalningsmetoden som är kopplad till prenumerationen, med en “Edit”-knapp
Faktureringsinformation: Namn, e-postadress, telefonnummer och faktureringsadress med en “Edit”-knapp
Faktureringshistorik: En detaljerad tabell över alla betalningar för denna prenumeration
Pausa: Ett alternativ för att pausa prenumerationen, som visas när du tillåter pausning via självbetjäning
Cancel Subscription: En framträdande knapp för att avsluta prenumerationen

Avsluta en prenumeration

Kunder kan avsluta sin prenumeration direkt från sidan med prenumerationsdetaljer. När de klickar på “Cancel Subscription” öppnas en bekräftelsedialog med två alternativ:

Avsluta vid nästa faktureringsdatum: Prenumerationen förblir aktiv tills den aktuella faktureringsperioden tar slut och avslutas sedan automatiskt.
Avsluta nu: Prenumerationen avslutas omedelbart.

Avslut via självbetjäning styrs av inställningen Allow Subscription Cancellation under Settings → Subscriptions, som är aktiverad som standard. När du inaktiverar den är knappen Cancel Subscription inaktiverad och visar ett verktygstips som ber kunden att kontakta dig, och båda vägarna för att avsluta via portalen — avsluta nu och avsluta vid nästa faktureringsdatum — avvisas. Kunder som redan har ett schemalagt avslut kan fortfarande återkalla det, så att de kan välja att stanna kvar. Avslut som du själv genomför påverkas aldrig.

Cancel subscription dialog with options to cancel at next billing date or cancel immediately

Orsaker till avslut

Innan avslutet bekräftas får kunder frågan “Varför avslutar du?” och ombeds välja en orsak från en utvald lista. Orsaken sparas på prenumerationen och visas i webhook-payloads och API:t, så att du kan analysera orsaker till kundbortfall och anpassa dina win-back-flöden.

Cancellation modal with the 'Why are you cancelling?' dropdown showing reasons like Too expensive, Missing features, and Other

Värde	Kundinriktad etikett
`too_expensive`	För dyrt
`missing_features`	Saknade funktioner
`switched_service`	Bytte till en annan tjänst
`unused`	Använder det inte tillräckligt
`customer_service`	Dålig kundservice
`low_quality`	Låg kvalitet
`too_complex`	För komplext
`other`	Annat

Det valda värdet skrivs till prenumerationens cancellation_feedback-fält. Ett valfritt fritextfält, cancellation_comment, kan också samlas in.

// Read the captured feedback after a customer cancels
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"

Båda fälten ingår även i webhook-payloaden subscription.cancelled, och du kan fylla i dem programmatiskt via PATCH /subscriptions/{subscription_id} när du schemalägger eller genomför ett avslut via API:t.

Kombinera cancellation_feedback med Subscription Dunning för att anpassa win-back-e-postmeddelanden — skicka till exempel en rabattkod till kunder som avslutar på grund av too_expensive och en enkät om “vad som saknas” till kunder som avslutar på grund av missing_features.

Pausa en prenumeration

Pausning ger kunderna ett mellanting mellan att behålla en prenumeration och att avsluta den helt. En pausad prenumeration stoppar faktureringen men behåller sin plan och historik, så att kunden kan återkomma till den senare i stället för att börja om från början. Kunder öppnar pausdialogen från sidan med prenumerationsdetaljer. Dialogen anger den aktuella planen, varnar för att åtkomsten upphör omedelbart och förklarar hur faktureringsdatumen förskjuts. Kunden bekräftar med Pause subscription.

Det här informeras kunden om, och det här händer i praktiken:

Åtkomsten upphör direkt. Funktioner, nedladdningar och licensnycklar som ingår i prenumerationen slutar fungera tills prenumerationen återupptas.
Pausen har inget slutdatum. Prenumerationen förblir pausad tills kunden återupptar den.
Ingen tid går förlorad. Nästa faktureringsdatum och förnyelsedatumet flyttas båda fram med pausens längd.

Återupptagning följer samma flöde. Prenumerationen återgår till active och åtkomsten återställs.

Pausning via självbetjäning styrs av inställningen Allow Subscription Pause under Settings → Subscriptions, och den är inaktiverad som standard. När den är inaktiverad kan kunder inte starta en ny paus, men en kund som redan har pausat en prenumeration kan fortfarande återuppta en paus som kunden själv startade. Pauser som du själv genomför från kontrollpanelen påverkas aldrig.

How Pausing Works

Fullständigt pausningsbeteende, inklusive faktureringseffekter, reglering av användning och webhooks.

Uppdatera betalningsmetoder

Kunder kan uppdatera sina betalningsmetoder direkt från sidan med prenumerationsdetaljer genom att klicka på “Edit” bredvid betalningsmetoden. Den här funktionen är särskilt viktig för att återaktivera prenumerationer som har placerats i vänteläge på grund av misslyckade betalningar.

Återaktivera prenumerationer i vänteläge

När en prenumeration förs till tillståndet on_hold på grund av en misslyckad betalning måste kunden uppdatera sin betalningsmetod för att återaktivera den. Uppdateringsprocessen gör automatiskt följande:

Skapar en debitering för återstående skulder
Genererar en faktura för debiteringen
Behandlar betalningen med den nya betalningsmetoden
Återaktiverar prenumerationen till tillståndet active när betalningen har genomförts

Prenumerationer i tillståndet on_hold förnyas inte automatiskt. Kunder måste uppdatera sin betalningsmetod för att betala återstående skulder och återaktivera prenumerationen.

När betalningsmetoden för en prenumeration i tillståndet on_hold har uppdaterats visas en bekräftelsesida för kunden, som även får e-postaviseringar om den genomförda betalningen och den återaktiverade prenumerationen.

Flöde för uppdatering av betalningsmetod

Access subscription details

Klicka på “Manage subscription” för en aktiv prenumeration från portalens startsida.

Click Edit on payment method

Klicka på knappen “Edit” bredvid betalningsmetoden för att öppna gränssnittet för uppdatering av betalningsmetod.

Select or add payment method

Välj en befintlig sparad betalningsmetod eller lägg till en ny genom att ange kortuppgifterna på ett säkert sätt.

Confirm changes

Bekräfta uppdateringen. För prenumerationer i tillståndet on_hold skapas då automatiskt en debitering för återstående skulder.

Complete payment (if on hold)

Om prenumerationen är i vänteläge omdirigeras kunden för att slutföra betalningen av återstående skulder. När betalningen har genomförts återaktiveras prenumerationen automatiskt.

Confirmation

Kunder får en bekräftelse på att betalningsmetoden har uppdaterats och, i förekommande fall, att prenumerationen har återaktiverats.

Integreringsexempel

Skapa en tidsbegränsad Customer Portal-session för en specifik kund via API och omdirigera sedan användaren till sessions-URL:en.

const session = await client.customers.customerPortal.create('cus_123');

// Redirect the user to the hosted Customer Portal
window.location.href = session.link;

Unified Customer Portal

Utöver företagsspecifika kundportaler erbjuder Dodo Payments en Unified Customer Portal på customer.dodopayments.com, där kunder kan visa och hantera alla sina köp och prenumerationer hos olika företag som använder Dodo Payments.

Funktioner i Unified Portal

Överblick över flera företag: Visa alla köp och prenumerationer från valfri Dodo Payments-handlare på en och samma plats
Centraliserad hantering: Hantera prenumerationer hos olika företag från en enda kontrollpanel
Samlad faktureringshistorik: Få åtkomst till fakturor och betalningshistorik för alla köp
Single sign-on: Logga in en gång med e-post för att få åtkomst till köp hos alla Dodo Payments-handlare

Unified Customer Portal kompletterar företagsspecifika portaler. Kunder kan använda antingen den varumärkesanpassade handlarportalen eller den enhetliga portalen, beroende på vad de föredrar.

Felsökning

Länken har löpt ut: Generera och skicka en ny dynamisk länk.
E-postadressen känns inte igen: Be kunden använda e-postadressen som är kopplad till köpet
Prenumerationen är i vänteläge: Om en prenumeration är i vänteläge måste kunden uppdatera sin betalningsmetod via portalen för att betala återstående skulder och återaktivera prenumerationen. Uppdateringsprocessen debiterar automatiskt återstående skulder.
Uppdateringen av betalningsmetoden misslyckades: Om betalningen misslyckas under uppdateringsprocessen för en prenumeration i tillståndet on_hold förblir prenumerationen i vänteläge. Kunden kan försöka igen med en annan betalningsmetod.

Design & Theme Customization

Anpassa utseendet på din kundportal med färdiga teman, typografi, färger och liveförhandsvisning från designsidan.

Create Portal Session (API)

Subscriptions

​Vad är kundportalen?

​Nyckelfördelar

​Åtkomstmetoder

​Statisk länk (e-postbaserad åtkomst)

​Dynamisk länk (magisk länk)

​Portalens funktioner

Active Subscriptions

Payment Methods

Billing History

Billing Information

​Portalöversikt

​Betalningsmetoder och faktureringshistorik

​Planändringar (uppgradering/nedgradering)

​Hur planändringar fungerar

​Företagskontroller

Product Collections

​Samla in betalningar för planändringar via payment link

Plan Change via Payment Link (API)

​Företagsinställningar

Product Collections

​Prenumerationsdetaljer

​Avsluta en prenumeration

​Orsaker till avslut

​Pausa en prenumeration

How Pausing Works

​Uppdatera betalningsmetoder

​Återaktivera prenumerationer i vänteläge

​Flöde för uppdatering av betalningsmetod

​Integreringsexempel

​Unified Customer Portal

​Funktioner i Unified Portal

​Felsökning

Design & Theme Customization

Vad är kundportalen?

Nyckelfördelar

Åtkomstmetoder

Statisk länk (e-postbaserad åtkomst)

Dynamisk länk (magisk länk)

Portalens funktioner

Portalöversikt

Betalningsmetoder och faktureringshistorik

Planändringar (uppgradering/nedgradering)

Hur planändringar fungerar

Företagskontroller

Samla in betalningar för planändringar via payment link

Företagsinställningar

Prenumerationsdetaljer

Avsluta en prenumeration

Orsaker till avslut

Pausa en prenumeration

Uppdatera betalningsmetoder

Återaktivera prenumerationer i vänteläge

Flöde för uppdatering av betalningsmetod

Integreringsexempel

Unified Customer Portal

Funktioner i Unified Portal

Felsökning