Tarification multidevise
(TMD ou MCP)

Tarification multidevise (TMD ou MCP) est un service financier qui permet aux entreprises de fixer le prix des biens et services dans une variété de devises étrangères, tout en continuant de recevoir le règlement et les rapports en dollars canadiens. TMD ou MCP permet aux titulaires de carte de magasiner, de voir les prix et de payer dans la devise de leur choix.

REMARQUE : Utilisez TMD ou MCP uniquement lors du traitement de transactions qui impliquent un échange de devises étrangères; pour les transactions strictement en dollars canadiens, utilisez les requêtes de transactions financières de base.

1. Mise en route avec la tarification multidevise (TMD ou MCP)

Support aux ventes de Moneris

Téléphone: 1-855-465-4980

Pour commencer à traiter des transactions de tarification multidevise (TMD ou MCP) dans votre magasin, vous devrez appeler le service de soutien aux ventes de Moneris afin d’activer cette fonctionnalité sur votre compte.

2. Méthodes de traitement des transactions de tarification multidevise (TMD ou MCP)

Il existe deux méthodes de traitement des transactions de TMD ou MCP via l’API de Passerelle de Moneris :

  • En utilisant l’appel API de recherche de taux de tarification multidevise( Pricing Rate Lookup) – cette méthode est utilisée pour obtenir un taux de change étranger et verrouille ce taux spécifique pour une durée limitée; il est ensuite appliqué dans une transaction subséquente.

  • Sans utiliser l’appel API de recherche de taux de tarification multidevise (Pricing Rate Lookup)– cette méthode envoie une transaction TMD ou MCP sans effectuer la requête de recherche de taux, et le taux de change étranger est obtenu au moment du traitement.

3. Recherche de taux de tarification multidevise
(Pricing Rate Lookup)

Cet appel d’API effectue une recherche de taux de change en devise étrangère et sécurise ce taux de change pour une utilisation dans une transaction financière TMD ou MCP subséquente.

Réponse

Dans la réponse d’une requête de recherche de taux de tarification multidevise (TMD ou MCP), vous recevrez :

  • multiCurrencyPricingRateLookupId:
    Identifiant unique de la requête de recherche de taux. Cet identifiant sera transmis pour utiliser le taux récupéré dans la transaction TMD ou MCP correspondante.

  • multiCurrencyPricingTransactionType:
    Répète le type de transaction utilisé dans la requête.

  • rateValidityEndTime:
    Horodatage indiquant quand le taux retourné expire.

  • rateConversions (Array of Objects):
    Contient les détails de conversion pour chaque requête :

    • cardholderAmount: Montant dans la devise du titulaire de carte.

    • merchantSettlementAmount: Montant dans la devise du commerçant.

    • multiCurrencyPricingExchangeRate: Taux de change utilisé.

    • multiCurrencyPricingStatusCode: Code d’état indiquant le succès ou l’échec.

    • multiCurrencyPricingStatusMessage: Message lisible décrivant le résultat.

Requête

Cet appel d’API effectue une requête POST sur /multi-currency-pricing-rates. Certains champs importants de la requête à noter pour cet appel d’API incluent :

  • multiCurrencyPricingTransactionType (Enum)
    Spécifie le type de transaction pour laquelle le taux est demandé. Cela garantit que Moneris applique la logique de tarification correcte.

    Valeurs possibles :

    • PAYMENT

    • REFUND

    Ce champ est obligatoire et détermine comment le taux est calculé en fonction du type de transaction.

  • multiCurrencyPricingRateInformationRequests (Tableau d’objets)
    Il s’agit d’un tableau obligatoire contenant une ou plusieurs requêtes de recherche de taux. Chaque objet du tableau doit inclure :

    • amountType (Enum):

      • MERCHANT_SETTLEMENT: Le montant est dans la devise du commerçant. Moneris calculera le montant équivalent dans la devise du titulaire de carte.

      • CARDHOLDER_AMOUNT: Le montant est dans la devise du titulaire de carte. Moneris calculera le montant équivalent dans la devise du commerçant.

    • amount (Objet):

      • amount: Valeur entière en cents (par exemple, 10,59 $ → 1059)

      • currency: Code de devise ISO (par exemple, CAD, USD)

    • cardholderCurrency (Requis uniquement si amountType est MERCHANT_SETTLEMENT) :

      • Le code de devise ISO représentant la devise préférée du titulaire de carte (par exemple, USD, EUR).

4. Créer un paiement avec la tarification multidevise
(TMD ou MCP)

Les achats et les préautorisations TMD ou MCP peuvent être effectués en utilisant la requête API Create Payment. Quelques éléments clés à noter concernant une transaction TMD ou MCP incluent :

  • (Objet)
    Il s’agit d’un objet obligatoire.t.

  • amount (integer): Spécifie le montant de la transaction dans la devise du titulaire de carte.

  • currency (string): Spécifie la devise du titulaire de carte.

  • multiCurrencyPricing (Object)
    Cela vous permet de spécifier des informations relatives à vos transactions TMD ou MCP.

  • multiCurrencyPricingOptIn (enum - requis)

    • OPT_IN: Indique que la transaction sera effectuée avec TMD ou MCP.

  • multiCurrencyPricingRateLookupId (string)

    • Permet d’utiliser le taux provenant d’une requête de recherche de taux de tarification multidevise (TMD ou MCP)..

5. Transactions subséquentes avec la tarification multidevise (TMD ou MCP)

De façon similaire aux transactions de paiement classiques, vous pouvez exécuter des transactions subséquentes pour les paiements TMD ou MCP. Ces transactions subséquentes incluent :

  1. Annuler un paiement : Annuler une transaction TMD ou MCP.

  2. Compléter un paiement : Compléter une préautorisation TMD ou MCP (Créer un paiement avec automaticCapture = false).

  3. Créer un remboursement : Effectuer un remboursement correspondant sur une transaction TMD ou MCP ou effectuer un remboursement indépendant en utilisant TMD ou MCP.

Pour les paiements complétés et les remboursements créés avec TMD ou MCP, vous pouvez effectuer une recherche de taux de tarification multidevise (TMD ou MCP) afin de sécuriser un taux de change avant votre transaction subséquente.

Renseignements Supplémentaires

Définitions de l’API

Consultez les endpoints (points de terminaison), les formats des demandes et des réponses, ainsi que les modes d’authentification de ce scénario.

Définitions de l’API