Créer un nouvel objet de taux de change
Pour récupérer un nouveau taux de change entre deux devises, vous pouvez utiliser la mutation createExchangeRate via notre API GraphQL. createExchangeRate prend en charge un code de devise source et cible, ainsi qu'un type de taux. La documentation complète autour de la mutation createExchangeRate peut être trouvée sur notre référence API GraphQL. Les taux de change récupérés avec notre API sont spécifiques à l'organisation.
Mutation
mutation {
exchangeRateCreate(
input: {
sourceCurrencyCode: GBP
targetCurrencyCode: EUR
type: MID_MARKET
}
) {
id
rate
sourceCurrencyCode
targetCurrencyCode
}
}
Réponse
{
"data": {
"createExchangeRate": {
"id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
"rate": 0.6391,
"sourceCurrencyCode": "GBP",
"targetCurrencyCode": "EUR"
}
}
}
Récupérer un rate de change existant
Vous pouvez utiliser la requête exchangeRate avec un ID fourni pour récupérer les détails du rate de change précédemment récupéré. Cela est utile si vous souhaitez voir les détails historiques du rate de change, les utiliser pour des rapports, des interfaces utilisateur, etc. Vous pouvez voir une liste complète des champs disponibles sur la référence API GraphQL.
Les taux créés précédemment ne sont pas actualisés lorsque vous les récupérez, ils sont figés dans le temps au moment où ils ont été initialement récupérés.
Mutation
query {
exchangeRate(id: "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616") {
// Field names here...
}
}
Réponse
{
"data": {
"exchangeRate": {
"id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
"rate": 0.6391,
"sourceCurrencyCode": "CAD",
"targetCurrencyCode": "GBP",
"targetFormat": {
"decimalDelimiter": ".",
"symbol": "£",
"thousandsDelimiter": ","
}
}
}
}
Taux de change Google vs taux de change Zonos
Lorsque vous utilisez Google pour les taux de change, vous obtiendrez une valeur différente de celle que notre API fournit. Le taux de change rate que votre client voit en ligne n'est pas un taux de change rate pour les consommateurs. Si vous recherchez sur Google le taux de conversion actuel de USD à GBP rate, ce que vous verrez est le taux de change « de référence » rate. Il s'agit du taux de change rate auquel les grandes banques internationales échangent des centaines de millions de dollars, mais personne ne peut acheter à ce taux de change rate. Un consommateur verra ce taux de référence rate plus les frais facturés par la société de change lorsque les taux de change Zonos ne sont pas utilisés.
Les autres sites que vous voyez affichent probablement le taux de change rate par souci de commodité, mais ils ne facturent pas réellement le client dans leur devise étrangère. Les compagnies de cartes de crédit et les banques émettrices de la carte factureront des frais de change et des frais de transaction à l'étranger aux clients qui achètent sur des sites qui facturent en USD. Même s'ils affichent la devise en GBP (ou toute autre devise), le montant affiché lors du checkout n'est pas le montant que le client paiera finalement.
Comme mentionné précédemment, nous offrons un taux de change garanti rate. Les frais supplémentaires que nous facturons tiennent compte du marché des changes constamment fluctuant. Des variations sont susceptibles de se produire pendant la période garantie de 90 jours pour le taux de change rate initialement récupéré. Les frais supplémentaires garantissent que le montant affiché et payé par le client lors du checkout est le coût total et final qu'ils paieront—sans frais cachés ou surprises ultérieurement.
Récupérer des taux de change
Apprenez à récupérer un taux de change.Zonos prend en charge la récupération des taux de change à jour entre deux devises via notre API GraphQL. Nous garantissons les taux de change que nous calculons entre les devises. Bien que nous mettions à jour nos taux toutes les 10 minutes, nous garantissons le taux à partir du moment où il a été récupéré pendant 90 jours.
Zonos ne garantit les taux de change que dans les cas où nous gérons les paiements internationaux, comme via Zonos Checkout ou des intégrations personnalisées avec notre API de paiements Zonos. Pour connaître tous les détails sur la manière dont nous garantissons les taux de change, consultez nos Conditions d'utilisation.