Tarification Localisée

​

Qu’est-ce que la Tarification Localisée ?

​

Cas d’utilisation

​

Concepts de Base

• Modes de tarification — Un produit utilise exactement un mode à la fois, défini par son pricing_mode:
  • by_currency : un prix par devise, quel que soit le pays. Toute personne payant en EUR voit 9,99 €.
  • by_country : un prix spécifique à un pays (₹999 en Inde), même lorsque plusieurs pays partagent la même devise.
• Montants fixes, dans la plus petite unité — Le amount d’une règle est un entier exprimé dans la plus petite unité de la devise, comme partout ailleurs dans l’API : 99900 correspond à 999,00 ₹, 999 correspond à 9,99 €. Il s’agit d’un prix que vous définissez, jamais d’une valeur convertie.
• Une règle correspondante est prioritaire sur la tarification automatique — Lorsqu’une règle localisée s’applique à une ligne, la Parité de pouvoir d’achat et la Tarification psychologique sont toutes deux ignorées pour cette ligne. Le client paie le montant que vous avez défini, sans modification.
• Lorsqu’aucune règle ne correspond — Le produit conserve son comportement existant : les clients dans votre devise de base paient directement le prix de base ; tous les autres bénéficient d’une conversion via Adaptive Currency.
• Les frais sont inclus lorsqu’une règle correspond — Le client paie exactement le montant que vous avez défini. Les frais de change de Adaptive Currency sont pris en charge par vous (ils sont considérés comme inclus dans les frais pour cette transaction) plutôt qu’ajoutés au montant. Ainsi, le prix local indiqué est toujours le prix facturé.

​

Configurer dans le Tableau de Bord

1

Open the product form

Dans votre Tableau de Bord Marchand, allez à Produits et créez un produit (ou ouvrez un existant pour le modifier). Définissez le Prix de base et la devise comme d’habitude.

2

Enable Localized Pricing and choose a mode

Dans la section Tarification, cochez Tarification Localisée, puis choisissez Par Pays ou Par Devise.

3

Add a price for each market

Cliquez sur Ajouter un Prix par Pays ou Ajouter un Prix par Devise, remplissez le panneau Tarification localisée et cliquez sur Ajouter. Chaque marché que vous ajoutez apparaît dans le tableau des exceptions, où vous pouvez le modifier ou le supprimer plus tard.

• By Country
• By Currency

Choisissez un pays, sélectionnez la devise et entrez le montant (par exemple ₹999 pour l’Inde), puis cliquez sur Ajouter.

Le pays apparaît désormais dans le tableau des Exceptions par Pays, où vous pouvez le modifier ou le supprimer.

Choisissez une devise et entrez le montant (par exemple 9,99€ pour l’EUR), puis cliquez sur Ajouter.

La devise apparaît maintenant dans le tableau des Exceptions par Devise, où vous pouvez la modifier ou la supprimer.

4

Save the product

Sauvegardez avec Ajouter un produit. Les prix localisés s’appliquent immédiatement aux prochains paiements.

Effectuez un achat de test avec un pays de facturation qui a une règle, et confirmez que le montant localisé apparaît.

​

Gérer via l’API

​

Définir le mode de tarification

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
});

const product = await client.products.update('pdt_premium_plan', {
  pricing_mode: 'by_country',
});

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

product = client.products.update(
    "pdt_premium_plan",
    pricing_mode="by_country",
)

package main

import (
	"context"
	"os"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken(os.Getenv("DODO_PAYMENTS_API_KEY")),
	)

	_, err := client.Products.Update(
		context.TODO(),
		"pdt_premium_plan",
		dodopayments.ProductUpdateParams{
			PricingMode: dodopayments.F(dodopayments.PricingModeByCountry),
		},
	)
	if err != nil {
		panic(err)
	}
}

​

Ajouter un prix localisé

// ₹999.00 for customers in India
const localizedPrice = await client.products.localizedPrices.create('pdt_premium_plan', {
  currency: 'INR',
  country_code: 'IN',
  amount: 99900,
});

# ₹999.00 for customers in India
localized_price = client.products.localized_prices.create(
    "pdt_premium_plan",
    currency="INR",
    country_code="IN",
    amount=99900,
)

// ₹999.00 for customers in India
localizedPrice, err := client.Products.LocalizedPrices.New(
	context.TODO(),
	"pdt_premium_plan",
	dodopayments.ProductLocalizedPriceNewParams{
		Currency:    dodopayments.F(dodopayments.CurrencyInr),
		CountryCode: dodopayments.F(dodopayments.CountryCodeIn),
		Amount:      dodopayments.F(int64(99900)),
	},
)

​

Lister, mettre à jour et archiver

// List all active rules on a product
const rules = await client.products.localizedPrices.list('pdt_premium_plan');

// Change the amount (e.g. end a promo)
await client.products.localizedPrices.update('lcp_india_price', {
  product_id: 'pdt_premium_plan',
  amount: 119900,
});

// Archive a rule
await client.products.localizedPrices.archive('lcp_india_price', {
  product_id: 'pdt_premium_plan',
});

# List all active rules on a product
rules = client.products.localized_prices.list("pdt_premium_plan")

# Change the amount (e.g. end a promo)
client.products.localized_prices.update(
    "lcp_india_price",
    product_id="pdt_premium_plan",
    amount=119900,
)

# Archive a rule
client.products.localized_prices.archive(
    "lcp_india_price",
    product_id="pdt_premium_plan",
)

// List all active rules on a product
rules, err := client.Products.LocalizedPrices.List(context.TODO(), "pdt_premium_plan")

// Change the amount (e.g. end a promo)
_, err = client.Products.LocalizedPrices.Update(
	context.TODO(),
	"pdt_premium_plan",
	"lcp_india_price",
	dodopayments.ProductLocalizedPriceUpdateParams{
		Amount: dodopayments.F(int64(119900)),
	},
)

// Archive a rule
err = client.Products.LocalizedPrices.Archive(
	context.TODO(),
	"pdt_premium_plan",
	"lcp_india_price",
)

​

Comment cela s’applique lors du paiement

• Par Pays : cherche une règle correspondant au pays de facturation. Si elle existe, le client est facturé du montant de la règle dans la devise de la règle.
• Par Devise : cherche une règle correspondant à la devise du client (le billing_currency, ou la devise dérivée de son pays). Si elle existe, le client est facturé du montant de la règle dans cette devise.
• Aucune correspondance, ou pas de pricing_mode : le prix de base s’applique, facturé directement lorsque la devise du client est égale à la devise de base, sinon converti via Devise Adaptative.

​

Fonctionnement lors des changements de plan d’abonnement

• Par pays : une règle correspondant au pays de facturation de l’abonnement s’applique. Si la devise de la règle diffère de celle dans laquelle l’abonnement est facturé, le montant de la règle est converti selon les taux de change en temps réel — la règle est appliquée, et non ignorée.
• Par devise : une règle correspondant à la devise dans laquelle le client est facturé s’applique, et le client est facturé exactement du montant de la règle.
• Aucune correspondance ou aucun pricing_mode : le prix de base du nouveau plan s’applique, avec conversion via Adaptive Currency si nécessaire — le même mécanisme de repli qu’au checkout.

• Les aperçus sont exacts. Preview Change Plan renvoie le même montant localisé que celui facturé lors du changement réel.
• Les renouvellements conservent le prix localisé. Après le changement, le nouveau plan est renouvelé à son montant localisé — et reste frais inclus — exactement comme un abonnement créé à ce prix.
• La proratisation utilise les montants réels. Lors d’une mise à niveau, le crédit correspondant à la période inutilisée est calculé à partir de ce que le client a réellement payé pour l’ancien plan, tandis que le nouveau plan est tarifé selon sa règle localisée.
• Les changements planifiés bloquent le prix au moment de la planification. Un changement planifié à la fin de la période de facturation facture le montant calculé au moment de la planification, même si vous modifiez la règle entre-temps.
• La devise de facturation ne change jamais. Un changement de plan ne modifie jamais la devise dans laquelle un abonnement est réglé ; une règle dans une autre devise est convertie dans celle-ci selon le taux de change.
• Les modules complémentaires ne sont pas localisés. Les prix des modules complémentaires du nouveau plan utilisent toujours leur tarification de base.

​

Comportements importants

​

Bonnes pratiques

• Conservez un prix de base cohérent. Il sert de solution de repli pour tout marché sans règle, avec une conversion via Adaptive Currency.
• Saisissez des montants nets. Tout l’intérêt d’un montant fixe est d’obtenir un prix net comme ₹999, 9,99 € ou ¥1000, et non un résultat de conversion. Pour un arrondi automatique dans toutes les devises, consultez la Tarification psychologique.
• Choisissez le mode adapté à votre besoin. Utilisez by_country pour une tarification fondée sur le pouvoir d’achat ; utilisez by_currency lorsqu’un prix par zone monétaire suffit.
• Archivez plutôt que de recréer pour les promotions. L’archivage d’une règle fait revenir le marché à la tarification de base/adaptive tout en préservant l’historique ; recréez ou modifiez le prix ultérieurement si nécessaire.
• Vérifiez la fiscalité avant d’annoncer un prix total. Pour les produits hors taxes, le client paie le montant localisé plus les taxes. Ne le présentez donc pas comme le prix final dans vos publicités.

​

Articles associés