Le convertisseur de devises

Au sommaire dans cette page

L'API propose un convertisseur de devise avec /v1/calculations/currency/convert qui va tenir compte de toutes les subilités de calcul de devises (notamment la base et la coupure minimum) et retourner directement un résultat juste.

• calculationMode deux valeurs possibles, BUY ou SELL
• priceType deux valeurs possibles,WEB ou DESK
• currencyId l'id de la devise 
• exchangeMode deux valeurs possibles CURRENCY_TO_EURO ou EURO_TO_CURRENCY
• quantity quantité en euros ou en devises suivant le exchangeMode indiqué
• round nombre de décimales retournées, en générale 4, mais peuvent descendre à 2 si la devise n'est pas à base 1
• fees en général 0, montant en euros d'éventuels frais supplémentaires

Ainsi, si le marchand vend des Yens pour 850 euros au prix guichet

{
"calculationMode": "SELL",
"currencyId": 41,
"exchangeMode": "EURO_TO_CURRENCY",
"fees": 0,
"priceType": "DESK",
"quantity": 850,
"round": 4
}

L'API va retourner

• la conversion 
  • currencyConversion ISO = euroConversion EUR
  • 100300 JPY = 850 EUR
• le résultat de ce que le marchand peut fournir, qui tient compte de la coupure minimum (1000 dans cet exemple)
  • currencyResult ISO = euroResult EUR
  • 100000 JPY = 847.4576 EUR

{
  "exchangeMode": "EURO_TO_CURRENCY",
  "currencyConversion": 100300,
  "euroConversion": 850,
  "currencyResult": 100000,
  "euroResult": 847.4576
}