Scripts pour plusieurs devises

Créez des scripts qui prennent en charge la vente en plusieurs devises.

Sur cette page

Réductions fixes ou en pourcentage

Examinez le fonctionnement des réductions de script lorsque vous vendez en plusieurs devises. Il peut être difficile de commercialiser des réductions à montant fixe, car le montant peut varier en fonction des taux de conversion de devises.

Méthodes

Vous pouvez utiliser les méthodes suivantes pour limiter ou étendre les réductions à des devises spécifiques :

L’objet Panier possède une nouvelle méthode, presentment_currency. Cette méthode renvoie le code de la devise locale (de présentation) du client. Par exemple, vous pouvez utiliser cette méthode pour vérifier la devise de présentation de votre client et pour filtrer vos scripts en fonction du résultat.
L’objet Money possède une nouvelle méthode, Money.derived_from_presentment(customer_cents: X). Cette méthode renvoie la valeur dans la devise de la boutique. X représente le montant (formaté en centimes) dans la devise locale (de présentation) du client. Cette méthode convertit un montant dans la devise locale (de présentation) de votre client en montant équivalent dans la devise de votre boutique. Par exemple, vous pouvez utiliser cette méthode pour afficher les réductions de votre client dans sa devise locale (de présentation).

Conversions de devises

Les scripts Shopify s’exécutent dans la devise de votre boutique, et non dans la devise locale (de présentation) de votre client :

Avant l’exécution d’un script, les montants de votre panier sont convertis dans la devise de votre boutique.
Une fois le script terminé, ces montants sont reconvertis dans la devise locale (de présentation) de votre client.

Aucune de ces deux conversions n’entraîne de frais de conversion. Les frais de conversion ne vous sont facturés que lorsqu’un paiement est saisi.

Examiner vos scripts avant de vendre en plusieurs devises

Lorsque vous activez la vente en plusieurs devises, examinez vos scripts pour vous assurer qu’ils fonctionnent toujours comme prévu :

Scripts offrant une réduction en pourcentage – Ces scripts offrent la même réduction en pourcentage, quelle que soit la devise.
Scripts offrant une réduction d’un montant fixe – Les valeurs de ces scripts sont dans la devise de votre boutique. Les scripts qui offrent des réductions d’un montant fixe peuvent être difficiles à commercialiser, car le montant de la réduction peut fluctuer en fonction des taux de conversion de devise.
Scripts qui s’exécutent à partir d’un certain seuil de prix – Les valeurs de ces scripts sont dans la devise de votre boutique.

Exemple

L’exemple suivant masque tous les fournisseurs de services de paiement, à l’exception de Shopify Payments, lorsque la devise locale (de présentation) de votre client est différente de la devise de votre boutique :

Output.payment_gateways = Input.payment_gateways.delete_if do |payment_gateway|
  Input.cart.presentment_currency != Input.cart.shop_currency && payment_gateway.name != "Shopify Payments"
end