Qu’est-ce qu’un Price ?
Un Price (Prix) définit comment un SKU est facturé. Il peut s’agir d’un paiement unique ou d’un abonnement récurrent avec différentes périodicités.
Format de l’identifiant : price_ suivi de 36 caractères alphanumériques.Exemple : price_abc123def456ghi789jkl012mno345
Relation SKU → Price
Un SKU peut avoir plusieurs prix pour différentes stratégies tarifaires :
SKU "Formation Pro"
├── Price 99€ one-time (paiement unique)
├── Price 19€/mois (abonnement mensuel)
├── Price 199€/an (abonnement annuel avec économie)
└── Price 65 000 XOF one-time (marché africain)
Cette flexibilité permet de proposer plusieurs options de paiement pour le même produit et de gérer plusieurs devises.
Attributs du Price
Attributs principaux
| Attribut | Type | Description |
|---|
id | string | Identifiant unique du prix |
skuId | string | Référence au SKU parent |
amount | number | Montant en unité entière |
currency | string | Code devise (EUR, XOF, USD, etc.) |
type | enum | one_time ou recurring |
active | boolean | Prix actif et utilisable |
Attributs récurrents (abonnements)
| Attribut | Type | Description |
|---|
billingInterval | enum | day, week, month, year |
billingIntervalCount | number | Nombre d’intervalles (ex: 3 = tous les 3 mois) |
trialPeriodDays | number | null | Jours d’essai gratuit |
Types de tarification
Paiement unique
Abonnement récurrent
One-Time (one_time)
Le client paie une seule fois pour accéder au produit.Cas d’usage :
- Achats ponctuels
- Produits physiques
- Téléchargements numériques
- Accès à vie
curl -X POST https://api.yabetoo.com/v1/skus/sku_abc123/prices \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 99,
"currency": "EUR",
"type": "one_time"
}'
Recurring (recurring)
Le client est facturé automatiquement à intervalles réguliers.Cas d’usage :
- Abonnements SaaS
- Services continus
- Accès premium
- Maintenance
curl -X POST https://api.yabetoo.com/v1/skus/sku_abc123/prices \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 19,
"currency": "EUR",
"type": "recurring",
"billingInterval": "month",
"billingIntervalCount": 1,
"trialPeriodDays": 14
}'
Intervalles de facturation
Pour les prix récurrents, définissez la fréquence de facturation :
| Interval | Count | Description | Exemple |
|---|
day | 1 | Quotidien | Facturé chaque jour |
week | 1 | Hebdomadaire | Facturé chaque semaine |
week | 2 | Bi-hebdomadaire | Facturé toutes les 2 semaines |
month | 1 | Mensuel | Facturé chaque mois |
month | 3 | Trimestriel | Facturé tous les 3 mois |
month | 6 | Semestriel | Facturé tous les 6 mois |
year | 1 | Annuel | Facturé chaque année |
// Facturation trimestrielle
{
"type": "recurring",
"billingInterval": "month",
"billingIntervalCount": 3,
"amount": 45
}
Périodes d’essai
Offrez une période d’essai gratuit pour attirer de nouveaux clients :
{
"type": "recurring",
"billingInterval": "month",
"billingIntervalCount": 1,
"amount": 29,
"currency": "EUR",
"trialPeriodDays": 14
}
Début de l'abonnement
Le client s’inscrit et démarre sa période d’essai gratuite
Période d'essai
Pendant 14 jours, le client a accès complet sans être facturé
Fin de l'essai
À la fin de la période d’essai, le premier paiement est prélevé automatiquement
Cycle récurrent
Les paiements suivants sont prélevés selon l’intervalle défini
Assurez-vous d’informer clairement vos clients sur la durée de l’essai et le montant qui sera facturé après.
Gestion multi-devises
Créez plusieurs prix pour le même SKU dans différentes devises :
{
"sku": "sku_formation_pro",
"prices": [
{
"amount": 99,
"currency": "EUR",
"type": "one_time"
},
{
"amount": 109,
"currency": "USD",
"type": "one_time"
},
{
"amount": 65000,
"currency": "XOF",
"type": "one_time"
}
]
}
Devises supportées
| Code | Devise | Pays/Région |
|---|
EUR | Euro | Europe |
USD | Dollar américain | États-Unis |
XOF | Franc CFA BCEAO | Afrique de l’Ouest |
XAF | Franc CFA BEAC | Afrique Centrale |
GNF | Franc guinéen | Guinée |
CDF | Franc congolais | RD Congo |
Tous les montants sont exprimés en unités entières. Par exemple : 99 EUR = 99 €, 65000 XOF = 65 000 XOF.
Réponse API
Prix unique
Prix récurrent
{
"id": "price_abc123def456ghi789",
"object": "price",
"skuId": "sku_xyz789abc123def456",
"amount": 99,
"currency": "EUR",
"type": "one_time",
"billingInterval": null,
"billingIntervalCount": null,
"trialPeriodDays": null,
"active": true,
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z"
}
{
"id": "price_def456ghi789jkl012",
"object": "price",
"skuId": "sku_xyz789abc123def456",
"amount": 19,
"currency": "EUR",
"type": "recurring",
"billingInterval": "month",
"billingIntervalCount": 1,
"trialPeriodDays": 14,
"active": true,
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z"
}
Opérations courantes
Créer un prix
curl -X POST https://api.yabetoo.com/v1/skus/sku_abc123/prices \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 29,
"currency": "EUR",
"type": "recurring",
"billingInterval": "month",
"billingIntervalCount": 1
}'
Récupérer un prix
curl https://api.yabetoo.com/v1/prices/price_abc123 \
-H "Authorization: Bearer sk_live_..."
Désactiver un prix
Les prix ne peuvent pas être supprimés s’ils sont associés à des abonnements actifs. Utilisez la désactivation à la place.
curl -X PATCH https://api.yabetoo.com/v1/prices/price_abc123 \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"active": false
}'
Lister les prix d’un SKU
curl https://api.yabetoo.com/v1/skus/sku_abc123/prices \
-H "Authorization: Bearer sk_live_..."
Stratégies de tarification
Offre mensuelle vs annuelle
Proposez une réduction pour l’abonnement annuel :
{
"sku": "sku_saas_pro",
"prices": [
{
"amount": 29,
"currency": "EUR",
"type": "recurring",
"billingInterval": "month",
"billingIntervalCount": 1
},
{
"amount": 290,
"currency": "EUR",
"type": "recurring",
"billingInterval": "year",
"billingIntervalCount": 1
}
]
}
29 €/mois vs 290 €/an représente environ 2 mois gratuits, ce qui incite les clients à s’engager sur l’année.
Tarification par paliers
Créez des SKUs différents pour chaque niveau de service :
{
"product": "App Cloud",
"skus": [
{
"skuCode": "CLOUD-STARTER",
"prices": [{ "amount": 9, "currency": "EUR", "type": "recurring", "billingInterval": "month" }]
},
{
"skuCode": "CLOUD-PRO",
"prices": [{ "amount": 29, "currency": "EUR", "type": "recurring", "billingInterval": "month" }]
},
{
"skuCode": "CLOUD-ENTERPRISE",
"prices": [{ "amount": 99, "currency": "EUR", "type": "recurring", "billingInterval": "month" }]
}
]
}
Getters utiles
Le modèle Price fournit des getters pour faciliter les vérifications :
// Vérifier le type de prix
price.isRecurring // true si type === 'recurring'
price.isOneTime // true si type === 'one_time'
Bonnes pratiques
- Désactivez les anciens prix plutôt que de les supprimer
- Gardez les prix actifs au minimum nécessaire
- Utilisez des prix différents pour les promotions
- 7 à 14 jours est généralement optimal
- Trop court : pas assez de temps pour évaluer
- Trop long : perte de revenus potentielle
- Ajustez les prix pour chaque marché (pas de simple conversion)
- Tenez compte du pouvoir d’achat local
- Utilisez des prix psychologiques (29€ plutôt que 28,73€)
Prochaines étapes
Créer des promotions
Appliquez des réductions avec les coupons et codes promo
Gérer les abonnements
Comprenez le cycle de vie des abonnements
