License Keys
Digital Delivery
Payment Webhooks
Refunds API
Vad är engångsbetalningar?
Engångsbetalningar är fasta köp som betalas i förskott och passar bra för:- Programvarulicenser: Upplåsningar för livstid eller större versioner.
- Digitala nedladdningar: E-böcker, mallar, grafik eller plugins.
- Tjänster: Granskningar, onboardingpaket eller enstaka konsulttjänster.
- Kurser och biljetter: Kurser, workshoppar eller livesessioner.
Nyckelfördelar
- Enkel checkout: Inga förnyelser eller någon logik för proportionering.
- Omedelbar leverans: Leverera licenser eller filer direkt.
- Flexibel prissättning: Rabatter och skatter stöds.
- Utvecklarfokuserat: Tydliga API:er för skapande, återbetalningar och webhooks.
Skapa engångsprodukter
Skapa produkter i din Dodo Payments-instrumentpanel, och sälj dem via värd-kassa, betalningslänkar eller ditt API.
Produktkonfiguration
Konfigurera fälten i instrumentpanelen för att definiera hur din produkt visas och säljs.Produktinformation
- Produktnamn (obligatoriskt): Visningsnamnet som visas i checkout och på fakturor.
- Produktbeskrivning: Ett tydligt värdeerbjudande som kunderna ser innan de betalar.
- Produktbild: PNG, JPG eller WebP på högst 3 MB.
- Varumärke: Koppla produkten till ett specifikt varumärke för temaanpassning och e-postmeddelanden.
- Skattekategori (obligatoriskt): Välj rätt kategori för att fastställa skattereglerna.
Prissättning
- Pristyp: Välj Engångsbetalning.
- Pris (obligatoriskt): Fast avgift med valuta.
- Rabatt (%): Valfri procentuell rabatt som visas i kassan och på fakturor. Du kan ange upp till två decimaler, till exempel
10.5. I API:t använder dudiscount_bps(baspunkter, så1050är 10,5 %).
Avancerade inställningar
Dessa valfria inställningar finns i avsnitten Pricing, Entitlements och Meta Data i produktformuläret:- Tax Inclusive Pricing (i Pricing): Visa priser inklusive tillämpliga skatter.
- License key (i Entitlements): Utfärda en unik nyckel efter köp. Se Licensnycklar.
- Digital Files (i Entitlements): Leverera filer eller innehåll automatiskt. Se Leverans av digitala produkter.
- Meta Data: Lägg till anpassade nyckel-värde-par för intern taggning eller integrationer. Se Metadata.
API-hantering
Create Payments
Create Payments
Använd
POST /checkouts för att skapa en checkout-session som samlar in en engångsbetalning för dina produkter.API Reference
Refund Payments
Refund Payments
Använd
POST /refunds för att skapa fullständiga eller partiella återbetalningar.API Reference
List and Retrieve Payments
List and Retrieve Payments
Använd
GET /payments för att lista betalningar och GET /payments/{payment_id} för att hämta en. Hämta radposter med GET /payments/{payment_id}/line-items.List Payments
Get Payment Detail
Retrieve Line Items
Payment Webhooks
Payment Webhooks
Reagera på händelser som payment.succeeded eller payment.failed i din backend.
Webhook Guide
Vanliga användningsområden
- Licensbaserade verktyg: Lås upp funktioner med en engångsnyckel.
- Digitala tillgångar: Teman, mallar, ikonuppsättningar eller medier.
- Professionella tjänster: Implementering eller konfigurering till fast pris.
- Utbildning: Kursbiljetter och enstaka workshoppar.
Integrationsexempel
Checkout-sessioner (en betalning)
Skapa en checkout-session med en engångsprodukt i varukorgen:Bästa praxis
- Förtydliga leveransen: Berätta exakt för köparna vad de får och hur det levereras.
- Leverera direkt: Använd licensnycklar eller digital leverans för omedelbar åtkomst.
- Spåra med metadata: Lagra dina ID:n för enkel avstämning.