Nuove funzionalità
1. Supporto per Analisi di Terze Parti
Monitora il comportamento dei clienti su Storefront, Checkout e Customer Portal con Google Analytics 4, Google Tag Manager e Meta Pixel. Aggiungi i tuoi ID di tracciamento in Impostazioni → Analisi per iniziare a raccogliere eventi e-commerce.
Piattaforme supportate
| Platform | ID Format |
|---|
| Google Analytics 4 | G-XXXXXXXXXX |
| Google Tag Manager | GTM-XXXXXXX |
| Meta Pixel | Numeric (10-20 digits) |
purchase, add_payment_info, view_item e view_item_list vengono inviati automaticamente alle tue piattaforme di analisi mentre i clienti navigano e completano gli acquisti.
Supportato su Storefront, Checkout ospitato, Checkout overlay/inline e Customer Portal.
2. Personalizzazione del Tema del Checkout
Personalizza l’aspetto del checkout tramite il parametro customization.theme_config quando crei le sessioni di checkout. Configura colori, font, raggio dei bordi e testo dei pulsanti per modalità chiara e scura.
Opzioni di configurazione
| Property | Description |
|---|
light / dark | Schemi di colori per ciascuna modalità |
font_primary_url | URL del font personalizzato |
font_size | xs, sm, md, lg, xl, 2xl |
radius | Raggio dei bordi (es. 8px) |
pay_button_text | Testo personalizzato del pulsante |
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_123', quantity: 1 }],
customization: {
theme_config: {
radius: '8px',
pay_button_text: 'Complete Purchase',
light: { button_primary: '#0066ff', text_primary: '#1a1a1a' },
dark: { button_primary: '#3385ff', text_primary: '#ffffff' }
}
},
return_url: 'https://yoursite.com/return'
});
3. Impedire il Cambio Piano in Caso di Errore di Pagamento
Il nuovo parametro on_payment_failure per i cambi piano di abbonamento controlla il comportamento quando il pagamento fallisce.
| Mode | Behavior |
|---|
prevent_change | Mantieni l’abbonamento sul piano corrente fino al successo del pagamento |
apply_change | Applica subito il cambio piano indipendentemente dall’esito del pagamento (predefinito) |
await client.subscriptions.changePlan('sub_123', {
product_id: 'prod_pro',
proration_billing_mode: 'prorated_immediately',
on_payment_failure: 'prevent_change'
});
Usa prevent_change per aggiornamenti critici in cui vuoi assicurarti del pagamento prima di concedere l’accesso a funzionalità premium.
Aggiornamenti API
API del Ledger del Saldo
Nuovo endpoint GET /balances/ledger per recuperare le voci del ledger del tuo account con filtraggio e paginazione.
| Parameter | Description |
|---|
created_at_gte / created_at_lte | Filtra per intervallo di date |
event_type | Filtra per payment, refund, dispute, payout, ecc. |
currency | Filtra per codice valuta |
reference_object_id | Filtra per ID specifico di pagamento/rimborso/disputa |
Risposta di Pagamento: refund_status
Aggiunto il campo refund_status alla risposta GET /payments/{paymentId} per verificare rapidamente se un pagamento è stato rimborsato senza interrogare separatamente l’endpoint dei rimborsi.
