Nya funktioner
1. Stöd för tredjepartsanalys
Spåra kundbeteende i Storefront, Checkout och Customer Portal med Google Analytics 4, Google Tag Manager och Meta Pixel. Lägg till dina spårnings-ID:n i Settings → Analytics för att börja samla e-handelshändelser.
Stödda plattformar
| Plattform | ID-format |
|---|
| Google Analytics 4 | G-XXXXXXXXXX |
| Google Tag Manager | GTM-XXXXXXX |
| Meta Pixel | Numeric (10-20 digits) |
purchase, add_payment_info, view_item och view_item_list skickas automatiskt till dina analysplattformar när kunder bläddrar och genomför köp.
Stöds i Storefront, värdad Checkout, overlay/inline Checkout och Customer Portal.
2. Anpassning av checkouttema
Anpassa checkoutens utseende via customization.theme_config-parametern när du skapar checkoutsessioner. Konfigurera färger, typsnitt, hörnradie och knapptext för både ljusa och mörka lägen.
Konfigurationsalternativ
| Egenskap | Beskrivning |
|---|
light / dark | Färgscheman för varje läge |
font_primary_url | Anpassad typsnitt-URL |
font_size | xs, sm, md, lg, xl, 2xl |
radius | Hörnradie (t.ex. 8px) |
pay_button_text | Anpassad knapptext |
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. Förhindra planändring vid betalningsfel
Ny on_payment_failure-parameter för ändringar av prenumerationsplaner styr beteendet när betalningen misslyckas.
| Läge | Beteende |
|---|
prevent_change | Behåll prenumerationen på nuvarande plan tills betalningen lyckas |
apply_change | Tillämpa planändringen omedelbart oavsett betalningsresultat (standard) |
await client.subscriptions.changePlan('sub_123', {
product_id: 'prod_pro',
proration_billing_mode: 'prorated_immediately',
on_payment_failure: 'prevent_change'
});
Använd prevent_change för kritiska uppgraderingar där du vill säkerställa betalning innan premiumfunktioner aktiveras.
API-uppdateringar
Balance Ledger API
Ny GET /balances/ledger-slutpunkt för att hämta ditt kontos posteringar med filtrering och paginering.
| Parameter | Beskrivning |
|---|
created_at_gte / created_at_lte | Filtrera efter datumintervall |
event_type | Filtrera efter payment, refund, dispute, payout med mera |
currency | Filtrera efter valutakod |
reference_object_id | Filtrera efter specifikt betalnings-/återbetalnings-/tvist-ID |
Betalningssvar: refund_status
La till fältet refund_status i GET /payments/{paymentId}-svaret för att snabbt kontrollera om en betalning har återbetalats utan att fråga efter återbetalningsslutpunkten separat.
