Crea esperienze di checkout sicure e ospitate che gestiscono l’intero flusso di pagamento per acquisti una tantum e abbonamenti con pieno controllo sulla personalizzazione.
Validità della Sessione: Le sessioni di checkout sono valide per 24 ore per impostazione predefinita. Se passi confirm=true nella tua richiesta, la sessione sarà valida solo per 15 minuti.
import DodoPayments from 'dodopayments';// Initialize the Dodo Payments clientconst client = new DodoPayments({ bearerToken: process.env.DODO_PAYMENTS_API_KEY, environment: 'test_mode', // defaults to 'live_mode'});async function createCheckoutSession() { try { const session = await client.checkoutSessions.create({ // Products to sell - use IDs from your Dodo Payments dashboard product_cart: [ { product_id: 'prod_123', // Replace with your actual product ID quantity: 1 } ], // Pre-fill customer information to reduce friction customer: { email: 'customer@example.com', name: 'John Doe', phone_number: '+1234567890' }, // Billing address for tax calculation and compliance billing_address: { street: '123 Main St', city: 'San Francisco', state: 'CA', country: 'US', // Required: ISO 3166-1 alpha-2 country code zipcode: '94102' }, // Where to redirect after successful payment return_url: 'https://yoursite.com/checkout/success', // Custom data for your internal tracking metadata: { order_id: 'order_123', source: 'web_app' } }); // Redirect your customer to this URL to complete payment console.log('Checkout URL:', session.checkout_url); console.log('Session ID:', session.session_id); return session; } catch (error) { console.error('Failed to create checkout session:', error); throw error; }}// Example usage in an Express.js routeapp.post('/create-checkout', async (req, res) => { try { const session = await createCheckoutSession(); res.json({ checkout_url: session.checkout_url }); } catch (error) { res.status(500).json({ error: 'Failed to create checkout session' }); }});
Copia
import osfrom dodopayments import DodoPayments# Initialize the Dodo Payments clientclient = DodoPayments( bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"), # This is the default and can be omitted environment="test_mode", # defaults to "live_mode")def create_checkout_session(): """ Create a checkout session for a single product with customer data pre-filled. Returns the session object containing checkout_url for customer redirection. """ try: session = client.checkout_sessions.create( # Products to sell - use IDs from your Dodo Payments dashboard product_cart=[ { "product_id": "prod_123", # Replace with your actual product ID "quantity": 1 } ], # Pre-fill customer information to reduce checkout friction customer={ "email": "customer@example.com", "name": "John Doe", "phone_number": "+1234567890" }, # Billing address for tax calculation and compliance billing_address={ "street": "123 Main St", "city": "San Francisco", "state": "CA", "country": "US", # Required: ISO 3166-1 alpha-2 country code "zipcode": "94102" }, # Where to redirect after successful payment return_url="https://yoursite.com/checkout/success", # Custom data for your internal tracking metadata={ "order_id": "order_123", "source": "web_app" } ) # Redirect your customer to this URL to complete payment print(f"Checkout URL: {session.checkout_url}") print(f"Session ID: {session.session_id}") return session except Exception as error: print(f"Failed to create checkout session: {error}") raise error# Example usage in a Flask routefrom flask import Flask, jsonify, requestapp = Flask(__name__)@app.route('/create-checkout', methods=['POST'])def create_checkout(): try: session = create_checkout_session() return jsonify({"checkout_url": session.checkout_url}) except Exception as error: return jsonify({"error": "Failed to create checkout session"}), 500
Copia
// Direct API call using fetch - useful for any JavaScript environmentasync function createCheckoutSession() { try { const response = await fetch('https://test.dodopayments.com/checkouts', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}` }, body: JSON.stringify({ // Products to sell - use IDs from your Dodo Payments dashboard product_cart: [ { product_id: 'prod_123', // Replace with your actual product ID quantity: 1 } ], // Pre-fill customer information to reduce checkout friction customer: { email: 'customer@example.com', name: 'John Doe', phone_number: '+1234567890' }, // Billing address for tax calculation and compliance billing_address: { street: '123 Main St', city: 'San Francisco', state: 'CA', country: 'US', // Required: ISO 3166-1 alpha-2 country code zipcode: '94102' }, // Where to redirect after successful payment return_url: 'https://yoursite.com/checkout/success', // Custom data for your internal tracking metadata: { order_id: 'order_123', source: 'web_app' } }) }); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const session = await response.json(); // Redirect your customer to this URL to complete payment console.log('Checkout URL:', session.checkout_url); console.log('Session ID:', session.session_id); return session; } catch (error) { console.error('Failed to create checkout session:', error); throw error; }}// Example: Redirect user to checkoutcreateCheckoutSession().then(session => { window.location.href = session.checkout_url;});
Dirigi il tuo cliente all’URL di checkout per completare il suo acquisto.
Copia
// Redirect immediatelywindow.location.href = session.checkout_url;// Or open in new windowwindow.open(session.checkout_url, '_blank');
Opzioni di Integrazione Alternative: Invece di reindirizzare, puoi incorporare il checkout direttamente nella tua pagina utilizzando Overlay Checkout (overlay modale) o Inline Checkout (completamente incorporato). Entrambe le opzioni utilizzano lo stesso URL della sessione di checkout.
3
Gestisci il ritorno
Dopo il pagamento, i clienti vengono reindirizzati al tuo return_url con parametri di query aggiuntivi per lo stato del pagamento.
Array di prodotti da includere nella sessione di checkout. Ogni prodotto deve avere un valido product_id dal tuo dashboard di Dodo Payments.
Checkout Misto: Puoi combinare prodotti di pagamento una tantum e prodotti in abbonamento nella stessa sessione di checkout. Questo consente casi d’uso potenti come le spese di attivazione con abbonamenti, bundle hardware con SaaS e altro ancora.
Mostra Proprietà dell'Elemento del Carrello Prodotti
Importo che il cliente paga se pay_what_you_want è abilitato. Se disabilitato, questo campo verrà ignorato.Formato: Rappresentato nella denominazione più bassa della valuta (ad es., centesimi per USD). Ad esempio, per addebitare $1.00, passa 100.
Trova i tuoi ID Prodotto: Puoi trovare gli ID prodotto nel tuo dashboard di Dodo Payments sotto Prodotti → Visualizza Dettagli, o utilizzando l’API Elenco Prodotti.
Numero di telefono del cliente in formato internazionale. Richiesto per alcuni metodi di pagamento e per la prevenzione delle frodi.Formato: Includi il prefisso del paese, ad es., "+1234567890" per numeri statunitensi
Indirizzo completo compreso il numero civico, il nome della strada e il numero dell’appartamento/unità se applicabile.Esempio: "123 Main St, Apt 4B" o "456 Oak Avenue"
Codice paese ISO a due lettere (ISO 3166-1 alpha-2). Questo campo è sempre richiesto quando viene fornito l’indirizzo di fatturazione.Esempi: "US" (Stati Uniti), "CA" (Canada), "GB" (Regno Unito), "DE" (Germania)
Controlla quali metodi di pagamento sono disponibili per i clienti durante il checkout. Questo aiuta a ottimizzare per mercati specifici o requisiti aziendali.Opzioni Disponibili: credit, debit, upi_collect, upi_intent, apple_pay, google_pay, amazon_pay, klarna, affirm, afterpay_clearpay, sepa, ach, cashapp, multibanco, bancontact_card, eps, ideal, przelewy24, paypal
Critico: Includi sempre credit e debit come opzioni di fallback per prevenire fallimenti del checkout quando i metodi di pagamento preferiti non sono disponibili.
Sovrascrivi la selezione della valuta predefinita con una valuta di fatturazione fissa. Usa i codici di valuta ISO 4217.Valute Supportate: USD, EUR, GBP, CAD, AUD, INR, e altroEsempio: "USD" per Dollari Statunitensi, "EUR" per Euro
Questo campo è efficace solo quando la tariffazione adattiva è abilitata. Se la tariffazione adattiva è disabilitata, verrà utilizzata la valuta predefinita del prodotto.
Abilita la modalità di raccolta indirizzo minimale. Quando abilitata, il checkout raccoglie solo:
Paese: Sempre richiesto per la determinazione delle tasse
Codice ZIP/Postale: Solo nelle regioni in cui è necessario per il calcolo delle tasse sulle vendite, IVA o GST
Questo riduce significativamente l’attrito del checkout eliminando campi di modulo non necessari.
Abilita l’indirizzo minimale per un completamento più veloce del checkout. La raccolta dell’indirizzo completo rimane disponibile per le aziende che richiedono dettagli di fatturazione completi.
Abilita la modalità di raccolta indirizzo minimale. Quando abilitata, il checkout raccoglie solo:
Paese: Sempre richiesto per la determinazione delle tasse
Codice ZIP/Postale: Solo nelle regioni in cui è necessario per il calcolo delle tasse sulle vendite, IVA o GST
Questo riduce significativamente l’attrito del checkout eliminando campi di modulo non necessari.
Abilita l’indirizzo minimale per un completamento più veloce del checkout. La raccolta dell’indirizzo completo rimane disponibile per le aziende che richiedono dettagli di fatturazione completi.
Prezzo del prodotto per l’addebito iniziale al cliente. Se non specificato, verrà utilizzato il prezzo memorizzato del prodotto.Formato: Rappresentato nella denominazione più bassa della valuta (ad es., centesimi per USD). Ad esempio, per addebitare $1.00, passa 100.
Sovrascrittura opzionale della descrizione del prodotto per la fatturazione e gli articoli di linea. Se non specificato, verrà utilizzata la descrizione memorizzata del prodotto.
Se le spese per la valuta adattiva devono essere incluse nel prezzo del prodotto (vero) o aggiunte sopra (falso). Ignorato se la tariffazione adattiva non è abilitata.
La sovrascrittura billing_currency ha effetto solo quando la valuta adattiva è abilitata nelle impostazioni del tuo account. Se la valuta adattiva è disabilitata, questo parametro non avrà effetto.
11. Utilizzo di Metodi di Pagamento Esistenti per Checkout Immediato
Utilizza un metodo di pagamento salvato dal cliente per creare una sessione di checkout che elabora immediatamente, saltando la raccolta del metodo di pagamento:
Copia
const session = await client.checkoutSessions.create({ product_cart: [ { product_id: 'prod_premium_plan', quantity: 1 } ], customer: { customer_id: 'cus_123' // Required when using payment_method_id }, payment_method_id: 'pm_abc123', // Use customer's saved payment method confirm: true, // Required when using payment_method_id return_url: 'https://yourapp.com/success'});
Quando utilizzi payment_method_id, confirm deve essere impostato su true e deve essere fornito un esistente customer_id. Il metodo di pagamento sarà convalidato per idoneità con la valuta del pagamento.
Il metodo di pagamento deve appartenere al cliente ed essere compatibile con la valuta del pagamento. Questo consente acquisti con un clic per i clienti di ritorno.
Genera link di pagamento accorciati e condivisibili con slugs personalizzati:
Copia
const session = await client.checkoutSessions.create({ product_cart: [ { product_id: 'prod_monthly_subscription', quantity: 1 } ], short_link: true, // Generate a shortened payment link return_url: 'https://yourapp.com/success', customer: { email: 'customer@example.com', name: 'John Doe' }});// The checkout_url will be a shortened, cleaner linkconsole.log(session.checkout_url); // e.g., https://checkout.dodopayments.com/buy/abc123
I link brevi sono perfetti per SMS, email o condivisione sui social media. Sono più facili da ricordare e costruiscono più fiducia nei clienti rispetto a URL lunghi.
Usa redirect_immediately: true quando hai una pagina di successo personalizzata che offre un’esperienza utente migliore rispetto alla pagina di successo del pagamento predefinita. Questo è particolarmente utile per app mobili e flussi di checkout incorporati.
Quando redirect_immediately è abilitato, i clienti vengono reindirizzati al tuo return_url immediatamente dopo il completamento del pagamento, saltando completamente la pagina di successo predefinita.
Prima di creare una sessione di checkout, puoi visualizzare il riepilogo dei prezzi, comprese tasse, sconti e totali. Questo è utile per visualizzare prezzi accurati ai clienti prima che procedano al checkout.
In precedenza, quando creavi un link di pagamento con Link Dinamici, era necessario fornire l’indirizzo di fatturazione completo del cliente.Con le Sessioni di Checkout, questo non è più necessario. Puoi semplicemente passare le informazioni che hai e noi ci occuperemo del resto. Ad esempio:
Se conosci solo il paese di fatturazione del cliente, fornisci solo quello.
Il flusso di checkout raccoglierà automaticamente i dettagli mancanti prima di spostare il cliente alla pagina di pagamento.
D’altra parte, se hai già tutte le informazioni richieste e vuoi saltare direttamente alla pagina di pagamento, puoi passare l’intero set di dati e includere confirm=true nel corpo della tua richiesta.
