Tarification Localisée

​

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

​

Cas d’utilisation

​

Concepts de Base

• Modes de tarification — Un produit est dans exactement un mode à la fois, défini par son pricing_mode :
  • by_currency : un prix par devise, indépendamment du pays. Tout le monde payant en EUR voit 9,99€.
  • by_country : un prix spécifique à un pays (₹999 en Inde), même lorsque plusieurs pays partagent une devise.
• Montants fixes, dans la plus petite unité — Le amount d’une règle est un entier dans la plus petite unité de la devise, comme partout ailleurs dans l’API : 99900 est ₹999,00, 999 est 9,99€. C’est un prix que vous définissez, jamais une valeur convertie.
• Quand 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 le reçoivent converti via Devise Adaptative.
• Les frais sont inclusifs lorsqu’une règle correspond — Le client paie exactement le montant que vous avez défini. Le frais de FX Devise Adaptative est à la charge de vous (traité comme inclus dans les frais pour cette transaction) plutôt que d’être ajouté au-dessus, donc votre prix local affiché 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 conversion via Adaptive Currency.
• Arrondissez à des prix locaux attractifs. L’objectif d’un montant fixe est d’obtenir un chiffre simple comme ₹999, €9.99 ou ¥1000, et non un résultat de conversion de change.
• Choisissez le mode adapté à votre objectif. Utilisez by_country pour une tarification basée sur le pouvoir d’achat ; utilisez by_currency lorsqu’un prix par zone monétaire suffit.
• Archivez au lieu de recréer pour les promotions. L’archivage d’une règle ramène le marché au prix de base/adaptatif tout en préservant l’historique ; recréez ou ajustez le prix ultérieurement si nécessaire.
• Tenez compte des taxes avant d’annoncer un total. Pour les produits dont les taxes sont exclues, 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