Récupérer et afficher les produits devises

L'API reflète le contenu de la base Yodaforex Web Connect : des produits peuvent être ajoutés, modifiés mais aussi supprimés par le marchand. Il convient au webmaster de traiter ces trois cas.

Accéder aux produits devises

/v1/products/currencies ou /v1/products/currencies/{currencyId} retournent l'intégralité des devises ou une devise spécifique.

Données d'identification du produit

• id code unique d'identification de devise
• iso code officiel de la devise, sur 3 caractères 
• name nom de la devise
• country pays

Données de classement et tri

• category Trois catégories au choix “étrangère”, “exotique” ou “hors cours”
• isFavorite La devise est cochée comme Favorite dans Yodaforex
• isNew La devise est cochée comme Nouvelle dans Yodaforex
• isSpecial La devise est cochée comme Spéciale dans Yodaforex
• isSoldOnline La devise est cochée comme Vente en ligne
• isBoughtOnline La devise est cochée comme Rachat en ligne
• isTC Ce ne sont pas des billets de banques mais des Traveller Cheques
• displayOrder Numéro d'ordre d'affichage

Données financières

Chaque produit a deux déclinaisons de prix : un prix guichet et un prix web.
Le marchand peut décider de différencier ces deux tarifs.

• base c'est l'unité de base, en général 1, mais qui peut être de 100, 1000
  Le Yen sera par exemple exprimé sous la forme 100 JPY = 0,7356 €
• deskBuyRate prix de rachat guichet
• deskSellRate prix de vente guichet
• webBuyRate prix de rachat web
• webSellRate prix de vente web
• smallestCut coupure minimum, plus petit billet délivré par le marchand, doit impérativement être pris en compte dans les calculs de conversions
  On ne pourra délivrer 900 yens à un client si la coupure minimum est de 1000

1 EUR = basexdeskBuyRate iso
base iso = 1/deskBuyRate EUR

Promotions

• webDiscountEndDate date et heure de fin d'une promotion web
• deskDiscountEndDate date et heure de fin d'une promotion guichet
• discountDeskBuyRate prix promotionnel de rachat guichet
• discountDeskSellRate prix promotionnel de vente guichet
• discountWebBuyRate prix promotionnel de rachat web
• discountWebSellRate prix promotionnel de vente web

Pour qu'une promotion soit applicable il faut vérifier que

1. la date de fin ne soit pas dépassée
2. le prix promotionnel soit plus avantageux pour le client

Autres

• fixing valeur boursière

Convertisseur de devises

Voir la page dédiée Le convertisseur de devises