Nouvelles fonctionnalités
1. Prise en charge des analyses tierces
Suivez le comportement des clients sur Storefront, Checkout et Customer Portal avec Google Analytics 4, Google Tag Manager et Meta Pixel. Ajoutez vos identifiants de suivi dans Paramètres → Analyses pour commencer à collecter les événements e-commerce.
Plateformes prises en charge
| 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 et view_item_list sont envoyés automatiquement à vos plateformes d’analyse au fur et à mesure que les clients naviguent et finalisent leurs achats.
Pris en charge sur Storefront, Checkout hébergé, Checkout superposé/inline et Customer Portal.
2. Personnalisation du thème de Checkout
Personnalisez l’apparence du checkout via le paramètre customization.theme_config lors de la création des sessions de checkout. Configurez les couleurs, les polices, le rayon des bordures et le texte des boutons pour les modes clair et sombre.
Options de configuration
| Property | Description |
|---|
light / dark | Schémas de couleurs pour chaque mode |
font_primary_url | URL de police personnalisée |
font_size | xs, sm, md, lg, xl, 2xl |
radius | Rayon de bordure (par ex. 8px) |
pay_button_text | Texte personnalisé des boutons |
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. Éviter le changement de forfait en cas d’échec de paiement
Le nouveau paramètre on_payment_failure pour les changements de forfait d’abonnement contrôle le comportement lorsque le paiement échoue.
| Mode | Comportement |
|---|
prevent_change | Maintenir l’abonnement sur le forfait actuel jusqu’à ce que le paiement réussisse |
apply_change | Appliquer immédiatement le changement de forfait indépendamment du résultat du paiement (par défaut) |
await client.subscriptions.changePlan('sub_123', {
product_id: 'prod_pro',
proration_billing_mode: 'prorated_immediately',
on_payment_failure: 'prevent_change'
});
Utilisez prevent_change pour les mises à niveau critiques lorsque vous souhaitez garantir le paiement avant d’accorder l’accès aux fonctionnalités premium.
Mises à jour de l’API
API du grand livre de solde
Nouveau point de terminaison GET /balances/ledger pour récupérer les écritures du grand livre de votre compte avec filtrage et pagination.
| Parameter | Description |
|---|
created_at_gte / created_at_lte | Filtrer par plage de dates |
event_type | Filtrer par payment, refund, dispute, payout, etc. |
currency | Filtrer par code de devise |
reference_object_id | Filtrer par ID spécifique de paiement/remboursement/litige |
Réponse de paiement : refund_status
Ajout du champ refund_status à la réponse GET /payments/{paymentId} pour vérifier rapidement si un paiement a été remboursé sans interroger séparément le point de terminaison des remboursements.
