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',
});

​

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,
});

​

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',
});

​

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.

​

Comportements Importants

​

Bonnes Pratiques

• Gardez un prix de base raisonnable. C’est la solution de repli pour chaque marché sans règle, convertie via Devise Adaptative.
• Arrondissez aux prix de charme locaux. Tout l’intérêt d’un montant fixe est un nombre net comme ₹999, 9,99€, ou ¥1000, pas un résultat FX.
• Choisissez le mode adapté à la tâche. Utilisez by_country pour une tarification basée sur le pouvoir d’achat ; utilisez by_currency lorsque un prix par zone de devise suffit.
• Archivez, ne recréez pas, pour les promotions. Archiver une règle ramène le marché à base/adaptatif tout en préservant l’historique ; recréez ou réajustez plus tard selon les besoins.
• Attention à la ligne fiscale avant de faire de la publicité pour un total. Pour les produits hors taxes, le client paie le montant localisé plus la taxe, alors ne l’annoncez pas comme le prix final dans les publicités.

​

Associé