Tarification Localisée

​

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

​

Cas d’utilisation

​

Concepts fondamentaux

• Modes de tarification — Un produit est associé à 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 utilisent la même devise.
• Montants fixes, dans la plus petite unité — La valeur 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 ₹ et 999 à 9,99 €. Il s’agit d’un prix que vous définissez, jamais d’une valeur convertie.
• Une règle correspondante prévaut sur la tarification automatique — Lorsqu’une règle localisée s’applique à une ligne, Parité de pouvoir d’achat et Tarification psychologique sont toutes deux ignorées pour cette ligne. Au checkout, le client paie le montant défini, sans modification. Lors d’un changement de plan d’abonnement, une règle dans une devise différente de celle de l’abonnement est convertie ; consultez Application lors des changements de plan d’abonnement.
• Lorsqu’aucune règle ne correspond — Le produit conserve son comportement existant : les clients utilisant votre devise de base paient directement le prix de base ; pour tous les autres, le prix est converti via Adaptive Currency.
• Les frais sont inclus lorsqu’une règle correspond — Le client paie exactement le montant défini. Les frais de change de Adaptive Currency sont absorbés par vos soins (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é.

​

Configuration dans le Dashboard

1

Open the product form

Dans votre Merchant Dashboard, accédez à Produits et créez un produit (ou ouvrez un produit 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, puis cliquez sur Ajouter. Chaque marché ajouté apparaît dans le tableau des remplacements, où vous pouvez le modifier ou le supprimer ultérieurement.

• By Country
• By Currency

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

Le pays apparaît maintenant dans le tableau Remplacements par pays, où vous pouvez le modifier ou le supprimer.

Sélectionnez une devise et saisissez le montant (par exemple 9,99 € pour l’EUR), puis cliquez sur Ajouter.

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

4

Save the product

Enregistrez avec Ajouter le produit. Les prix localisés s’appliquent immédiatement aux prochains checkouts.

Effectuez un checkout de test avec un pays de facturation associé à une règle, puis vérifiez que le montant localisé s’affiche.

​

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
_, 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",
)

​

Application lors du checkout

• Par pays : recherche une règle correspondant au pays de facturation. Si une règle existe, le client est facturé du montant de la règle dans sa devise.
• Par devise : recherche une règle correspondant à la devise du client (le billing_currency ou la devise déduite de son pays). Si une règle existe, le client est facturé du montant de la règle dans cette devise.
• Aucune correspondance ou aucun pricing_mode : le prix de base s’applique. Il est facturé directement lorsque la devise du client correspond à la devise de base ; sinon, il est converti via Adaptive Currency.

​

Application 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 aux 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 paie exactement le montant de la règle.
• Aucune correspondance ou aucun pricing_mode : le prix de base du nouveau plan s’applique, converti via Adaptive Currency si nécessaire — il s’agit du même comportement 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é, avec les 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 du montant réellement payé par le client pour l’ancien plan, tandis que le nouveau plan est tarifé selon sa règle localisée.
• Les changements programmés verrouillent le prix au moment de la programmation. Un changement programmé à la fin de la période de facturation facture le montant calculé au moment de la programmation, 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 cette devise par les 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

• Définissez un prix de base cohérent. Il sert de valeur de repli pour tout marché sans règle, avec conversion via Adaptive Currency.
• Saisissez des montants nets. L’objectif d’un montant fixe est d’obtenir un prix clair comme 999 ₹, 9,99 € ou 1 000 ¥, et non un résultat de conversion. Pour appliquer un arrondi automatique dans toutes les devises, consultez 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é au prix de base ou adaptatif tout en conservant l’historique ; recréez ou redéfinissez le prix ultérieurement si nécessaire.
• Tenez compte des taxes avant d’annoncer un 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