Neue Funktionen
1. Unterstützung für Drittanbieter-Analysen
Verfolgen Sie das Kundenverhalten über Storefront, Checkout und Customer Portal mit Google Analytics 4, Google Tag Manager und Meta Pixel. Fügen Sie Ihre Tracking-IDs unter Settings → Analytics hinzu, um mit der Erfassung von E-Commerce-Ereignissen zu beginnen.
Unterstützte Plattformen
| 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 und view_item_list werden automatisch an Ihre Analyseplattformen gesendet, während Kund:innen stöbern und Käufe abschließen.
Unterstützt auf Storefront, gehostetem Checkout, Overlay/Inline Checkout und Customer Portal.
2. Checkout-Theme-Anpassung
Passen Sie das Checkout-Aussehen über den customization.theme_config-Parameter beim Erstellen von Checkout-Sessions an. Konfigurieren Sie Farben, Schriftarten, Border-Radius und Schaltflächentext für den Hell- und Dunkelmodus.
Konfigurationsoptionen
| Property | Description |
|---|
light / dark | Farbschemata für jeden Modus |
font_primary_url | Benutzerdefinierte Schriftart-URL |
font_size | xs, sm, md, lg, xl, 2xl |
radius | Border-Radius (z. B. 8px) |
pay_button_text | Benutzerdefinierter Schaltflächentext |
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. Planänderung bei fehlgeschlagenen Zahlungen verhindern
Neuer on_payment_failure-Parameter für Abo-Planänderungen steuert das Verhalten, wenn eine Zahlung fehlschlägt.
| Modus | Verhalten |
|---|
prevent_change | Behalten Sie das Abonnement beim aktuellen Plan, bis die Zahlung erfolgreich ist |
apply_change | Wenden Sie die Planänderung sofort an, unabhängig vom Zahlungsergebnis (Standard) |
await client.subscriptions.changePlan('sub_123', {
product_id: 'prod_pro',
proration_billing_mode: 'prorated_immediately',
on_payment_failure: 'prevent_change'
});
Verwenden Sie prevent_change für kritische Upgrades, bei denen Sie sicherstellen möchten, dass die Zahlung erfolgt, bevor der Zugang zu Premium-Funktionen gewährt wird.
API-Updates
Balance-Ledger-API
Neue GET /balances/ledger-Endpunkt zum Abrufen der Ledger-Einträge Ihres Kontos mit Filterung und Paginierung.
| Parameter | Beschreibung |
|---|
created_at_gte / created_at_lte | Filter nach Datumsbereich |
event_type | Filter nach payment, refund, dispute, payout usw. |
currency | Filter nach Währungscode |
reference_object_id | Filter nach bestimmter Zahlungs-/Rückerstattungs-/Streit-ID |
Zahlungsreaktion: refund_status
Feld refund_status zur GET /payments/{paymentId}-Antwort hinzugefügt, um schnell zu prüfen, ob eine Zahlung zurückerstattet wurde, ohne die Rückerstattungs-Endpunkte separat abfragen zu müssen.
