Nouvelles fonctionnalités
1. Facturation basée sur le crédit
Dodo Payments prend désormais en charge la facturation basée sur le crédit, un système flexible permettant d’attribuer, de gérer et de suivre les droits de crédit sur les abonnements, les produits ponctuels et la facturation à l’usage. Plutôt que de facturer à l’usage ou de restreindre l’accès via des fonctionnalités, vous allouez un pool de crédits dont les clients se servent au fur et à mesure de leur consommation.
Ce que vous pouvez faire
| Fonctionnalité | Description |
|---|
| Unités personnalisées ou crédits en monnaie fiat | Définissez les crédits dans votre propre unité (appels API, jetons, heures de calcul) ou comme valeur monétaire réelle (USD, EUR) |
| Crédits par abonnement | Émettez des crédits à chaque cycle de facturation avec réémission automatique au renouvellement |
| Crédits ponctuels | Accordez un solde de crédits fixe à l’achat, idéal pour les packs de recharge ou les offres promotionnelles |
| Déduction à l’usage | Liez les crédits à des compteurs pour une déduction automatique basée sur des événements de consommation en temps réel |
| Report | Permettez aux crédits non utilisés d’être reportés avec un pourcentage max, un délai et un nombre de reports configurables |
| Contrôles de dépassement | Autorisez les clients à continuer d’utiliser votre service au-delà de leur solde, avec des options pour annuler, facturer ou reporter le déficit |
| Expiration | Définissez la validité des crédits de 7 jours à jamais, avec un nombre de jours personnalisé |
- Crédits émis - Accordés lorsqu’un client achète un produit avec droits de crédit attachés. Pour les abonnements, les crédits sont réémis à chaque cycle de facturation.
- Crédits consommés - Déduits au fur et à mesure de l’utilisation de votre service. Les compteurs déduisent automatiquement les crédits en fonction des événements en temps réel, ou vous pouvez les déduire manuellement via le tableau de bord ou l’API.
- Crédits expirent ou sont reportés - À la fin du cycle de facturation (ou après la période d’expiration configurée), les crédits non utilisés expirent ou sont reportés selon vos paramètres.
- Gestion des dépassements - Si les crédits sont épuisés en milieu de cycle, vous pouvez permettre la poursuite de l’utilisation et choisir la façon dont le dépassement est géré en fin de cycle.
Ajout de crédits aux produits
Les crédits sont ajoutés en tant que droits lors de la création de produit. Vous pouvez attacher jusqu’à 3 crédits par produit, et les crédits fonctionnent avec les trois types de tarification : abonnements, paiements ponctuels et facturation à l’usage.
// Create a checkout session for a product with attached credits
const session = await client.checkoutSessions.create({
product_cart: [
{
product_id: 'prod_ai_pro_plan',
quantity: 1,
}
],
customer: { email: 'customer@example.com' },
return_url: 'https://yourapp.com/success'
});
// Send usage events that deduct credits automatically
await fetch('https://api.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: `gen_${Date.now()}`,
customer_id: 'cus_abc123',
event_name: 'ai.generation',
timestamp: new Date().toISOString(),
metadata: { model: 'gpt-4', tokens: 1500 }
}]
})
});
| Événement | Description |
|---|
credit.added | Crédits accordés à un client |
credit.deducted | Crédits consommés via l’usage ou un débit manuel |
credit.expired | Crédits non utilisés expirés |
credit.rolled_over | Crédits reportés vers un nouveau droit |
credit.rollover_forfeited | Crédits perdus au nombre maximal de reports |
credit.overage_charged | Frais de dépassement appliqués |
credit.manual_adjustment | Ajustement manuel de crédit/débit effectué |
credit.balance_low | Solde tombé en dessous du seuil configuré |
Commencez avec des paramètres simples : pas de report, pas de dépassement, ajoutez de la complexité à mesure que vous apprenez comment vos clients utilisent les crédits. La plupart des paramètres peuvent être mis à jour à tout moment sans affecter les droits existants.
2. Personnalisation du design et du thème
Découvrez la nouvelle page Design, un hub unifié pour personnaliser l’apparence de votre paiement, vitrine et portail client depuis un seul endroit. Choisissez des thèmes préconçus, configurez la typographie et les couleurs, et appliquez des surcharges par section, le tout avec un aperçu en direct avant de sauvegarder.
Points forts
| Fonctionnalité | Description |
|---|
| Hub de design unifié | Configurez l’apparence du paiement, de la vitrine et du portail client depuis une seule page |
| Thèmes préconçus | Commencez avec un thème sélectionné (Dodo Pulses, Terminal, Bumblebee ou Bubblegum) et personnalisez-le |
| Mode clair et sombre | Définissez des palettes de couleurs distinctes pour chaque mode |
| Aperçu en direct | Voyez à quoi ressemblent vos modifications sur le paiement, le portail client et la vitrine avant de les enregistrer |
| Surcharges par section | Ajustez finement les sections individuelles sans impacter les autres |
| Contrôle programmatique | Basculez les thèmes au moment du paiement via l’API ou le SDK Checkout |
| Onglet | Objectif |
|---|
| Général | Nom de l’entreprise, logo, sélection du thème et paramètres avancés globaux |
| Paiement | Substituez les paramètres du thème spécifiquement pour la page de paiement |
| Vitrine | Substituez les paramètres du thème et configurez la mise en page de la vitrine |
| Portail client | Substituez les paramètres du thème pour le portail client |
- Dodo Pulses - Le thème par défaut avec des accents vert citron et une typographie sans serif épurée
- Terminal - Orienté développeur avec une typographie monospace et des accents bleu roi
- Bumblebee - Accents ambrés et dorés chaleureux avec un style audacieux et premium
- Bubblegum - Accents roses et magenta ludiques avec des coins entièrement arrondis
Après avoir sélectionné un thème préconçu, vous pouvez affiner les propriétés individuelles dans les paramètres avancés. Les propriétés non spécifiées reprennent les valeurs par défaut du thème.
3. Statut des remboursements et des litiges dans l’API de liste des paiements
Le point de terminaison GET /payments inclut désormais les champs refund_status et dispute_status dans chaque élément de paiement, ce qui vous permet de voir l’état du remboursement et du litige d’un coup d’œil sans récupérer les détails de chaque paiement.
| Champ | Type | Description |
|---|
refund_status | partial | full | null | Résumé de l’état du remboursement pour ce paiement. null s’il n’existe aucun remboursement réussi |
dispute_status | string | null | Dernier statut de litige pour ce paiement. null s’il n’existe aucun litige |
dispute_status : dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost
Vous pouvez également filtrer les paiements par statut de litige à l’aide du paramètre de requête dispute_status :
# List all payments with open disputes
curl -X GET 'https://api.dodopayments.com/payments?dispute_status=dispute_opened' \
-H 'Authorization: Bearer YOUR_API_KEY'
Utilisez ces champs pour créer des tableaux de bord litige et remboursement, déclencher des alertes sur les changements de statut de litige ou filtrer votre liste de paiements afin de mettre en avant ceux qui nécessitent une attention particulière.
4. Tableau des remboursements dans le portail client
Le portail client inclut désormais une section Remboursements dédiée où les clients peuvent voir tous les remboursements associés à leurs paiements. Chaque remboursement affiche son montant, son statut, sa date et le paiement d’origine auquel il a été lié, offrant aux clients une transparence totale sur leur historique de remboursements sans avoir à contacter le support.
Le tableau des remboursements est disponible automatiquement dans le portail client pour toutes les entreprises. Aucune configuration n’est nécessaire.
5. Copie en mode réel pour les compteurs
Vous pouvez désormais copier les compteurs du mode test vers le mode réel directement depuis le tableau de bord. Une fois que vous avez testé la configuration d’un compteur en mode test, utilisez l’action de copie pour le reproduire en mode réel avec tous les paramètres conservés : type d’agrégation, nom de l’événement, filtres et associations de crédits. Cela évite de recréer manuellement les compteurs lors du passage du développement à la production.
Créez et validez d’abord vos configurations de compteur en mode test, puis copiez-les en mode réel dès que vous êtes prêt à passer en production. Cela garantit que votre configuration de facturation est testée avant d’être utilisée par vos clients réels.
