Ny funktionalitet
1. Kreditbaserad fakturering
Dodo Payments stöder nu kreditbaserad fakturering, ett flexibelt system för att utfärda, hantera och spåra krediträttigheter över prenumerationer, engångsprodukter och fakturering baserad på användning. Istället för att debitera per användning eller begränsa åtkomst via funktionsflaggor fördelar du en pool med krediter som kunderna använder när de nyttjar din tjänst.
Vad du kan göra
| Funktion | Beskrivning |
|---|
| Anpassade enheter eller fiat-krediter | Definiera krediter i din egen enhet (API-anrop, tokens, beräkningstimmar) eller som faktisk valuta (USD, EUR) |
| Prenumerationskrediter | Utfärda krediter per faktureringscykel med automatisk återutgivning vid förnyelse |
| Engångskrediter | Tilldela en fast kreditbalans vid köp, idealiskt för påfyllnadspaket eller kampanjbundles |
| Avdrag baserat på användning | Koppla krediter till mätare för automatisk avdrag baserat på realtidsförbrukning |
| Överföring | Tillåt oanvända krediter att föras vidare med konfigurerbar maxprocent, tidsram och antal överföringar |
| Kontroller för övertrassering | Låt kunder fortsätta använda tjänsten efter saldot är slut, med alternativ att efterge, fakturera eller föra vidare underskottet |
| Utgång | Ange kreditgiltighet från 7 dagar till aldrig, med anpassade dagar |
- Krediter utfärdas - Ges när en kund köper en produkt med tillhörande krediträttigheter. För prenumerationer återutges krediter varje faktureringscykel.
- Krediter konsumeras - Dras av när kunder använder din tjänst. Mätare drar automatiskt av krediter baserat på realtids-händelser, eller så kan du dra av manuellt via panelen eller API:t.
- Krediter förfaller eller överförs - I slutet av faktureringscykeln (eller efter den konfigurerade utgångsperioden) förfaller oanvända krediter eller överförs beroende på dina inställningar.
- Hantering av övertrassering - Om krediter tar slut mitt i cykeln kan du tillåta fortsatt användning och välja hur övertrassering hanteras i slutet av cykeln.
Fästa krediter vid produkter
Krediter fästs som rättigheter i skapandeprocessen för produkter. Du kan fästa upp till 3 krediter per produkt, och krediter fungerar med alla tre prissättningsmetoder: prenumerationer, engångsbetalningar och fakturering baserad på användning.
// Create a checkout session for a product with attached credits
const session = await client.checkoutSessions.create({
product_cart: [
{
product_id: 'prod_ai_pro_plan',
quantity: 1,
}
],
customer: { email: 'customer@example.com' },
return_url: 'https://yourapp.com/success'
});
// Send usage events that deduct credits automatically
await fetch('https://api.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: `gen_${Date.now()}`,
customer_id: 'cus_abc123',
event_name: 'ai.generation',
timestamp: new Date().toISOString(),
metadata: { model: 'gpt-4', tokens: 1500 }
}]
})
});
| Händelse | Beskrivning |
|---|
credit.added | Krediter beviljade till en kund |
credit.deducted | Krediter förbrukade genom användning eller manuellt avdrag |
credit.expired | Oanvända krediter förfallna |
credit.rolled_over | Krediter förts vidare till ett nytt tilldelningssegment |
credit.rollover_forfeited | Krediter förlorade vid max antal överföringar |
credit.overage_charged | Avgifter för övertrassering applicerade |
credit.manual_adjustment | Manuell kredit-/debitjustering gjord |
credit.balance_low | Saldo sjönk under konfigurerad tröskel |
Börja med enkla inställningar: ingen överföring, ingen övertrassering, och lägg till komplexitet när du lär dig hur kunder använder krediter. De flesta inställningar kan uppdateras när som helst utan att påverka befintliga tilldelningar.
2. Design- och tema-anpassning
Vi introducerar den nya Design-sidan, ett enhetligt nav för att anpassa utseendet på din kassa, butik och Customer Portal från en och samma plats. Välj förbyggda teman, konfigurera typografi och färger, och tillämpa sektion-visa överskridanden – allt med liveförhandsvisning innan du sparar.
Höjdpunkter
| Funktion | Beskrivning |
|---|
| Enhetligt designnav | Konfigurera utseendet för kassa, butik och Customer Portal från en sida |
| Förbyggda teman | Börja med ett kuraterat tema (Dodo Pulses, Terminal, Bumblebee eller Bubblegum) och anpassa därifrån |
| Ljus- och mörkerläge | Definiera separata färgpaletter för respektive läge |
| Liveförhandsvisning | Se hur dina ändringar ser ut i kassan, Customer Portal och butik innan du sparar |
| Sektion-visa överskridanden | Finjustera individuella sektioner utan att påverka övriga |
| Programmatisk kontroll | Överstyr teman vid kassa via API eller Checkout SDK |
| Flik | Syfte |
|---|
| General | Företagsnamn, logotyp, temaval och globala avancerade inställningar |
| Checkout | Överstyr temainställningar specifikt för kassasidan |
| Storefront | Överstyr temainställningar och konfigurera butikslayouten |
| Customer Portal | Överstyr temainställningar för Customer Portal |
- Dodo Pulses - Standardtemat med limegröna accenter och ren sans-serif-typografi
- Terminal - Utvecklarorienterat med monospace-typografi och kungligt blå accenter
- Bumblebee - Varma amber- och guldaccenter med fet, premium känsla
- Bubblegum - Lekfulla rosa och magenta accenter med helt rundade hörn
Efter att ha valt ett förbyggt tema kan du vidare anpassa individuella egenskaper i Avancerade inställningar. Alla icke specificerade egenskaper återgår till temats standardvärden.
3. Återbetalningsstatus och tviststatus i List Payments API
Listendpointen GET /payments innehåller nu fälten refund_status och dispute_status i varje betalningspost, så att du snabbt kan se återbetalnings- och tviststatus utan att hämta individuella betalningsdetaljer.
| Fält | Typ | Beskrivning |
|---|
refund_status | partial | full | null | Sammanfattning av återbetalningsstatusen för denna betalning. null om inga lyckade återbetalningar finns |
dispute_status | string | null | Den senaste tviststatusen för denna betalning. null om inga tvister finns |
dispute_status-värden: dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost
Du kan också filtrera betalningar efter tviststatus med frågeparametern dispute_status:
# List all payments with open disputes
curl -X GET 'https://api.dodopayments.com/payments?dispute_status=dispute_opened' \
-H 'Authorization: Bearer YOUR_API_KEY'
Använd dessa fält för att bygga översikter över tvister och återbetalningar, trigga aviseringar vid tviststatusförändringar eller filtrera din betalningslista för att lyfta fram betalningar som kräver uppmärksamhet.
4. Återbetalningstabell i Customer Portal
Customer Portal inkluderar nu en dedikerad Refunds-sektion där kunder kan se alla återbetalningar kopplade till deras betalningar. Varje återbetalningspost visar belopp, status, datum och den ursprungliga betalning som återbetalningen gäller, vilket ger kunder full transparens i deras återbetalningshistorik utan att behöva kontakta support.
Återbetalningstabellen finns automatiskt tillgänglig i Customer Portal för alla företag. Ingen konfiguration krävs.
5. Kopiera till live-läge för mätare
Du kan nu kopiera mätare från testläge till live-läge direkt från panelen. När du har testat en mätarkonfiguration i testläge använder du kopieringsåtgärden för att replikera den i live-läge med alla inställningar bevarade: aggregeringstyp, händelsenamn, filter och kreditkopplingar. Detta eliminerar behovet av att återskapa mätare manuellt när du går från utveckling till produktion.
Bygg och validera dina mätarkonfigurationer i testläge först, och kopiera dem sedan till live-läge när du är redo för produktion. Detta säkerställer att din faktureringssetup testas innan den hanterar riktig kundanvändning.
