DOCS

Retrieve an exchange rate

/

Recupera i tassi di cambio

Scopri come recuperare un tasso di cambio rate.

Zonos supporta il recupero di tassi di cambio aggiornati tra due valute tramite la nostra GraphQL API. Garantiamo i tassi di cambio che calcoliamo tra le valute. Anche se aggiorniamo i nostri tassi ogni 10 minuti, garantiamo il rate dal momento in cui è stato recuperato per 90 giorni.

Zonos garantisce solo i tassi di cambio per le istanze in cui gestiamo pagamenti internazionali, come tramite Zonos Checkout o integrazioni personalizzate con la nostra Zonos Payments API. Per dettagli completi su come garantiamo i tassi di cambio, consulta i nostri Termini di Servizio.

Crea un nuovo oggetto tasso di cambio rate

Per recuperare un nuovo tasso di cambio rate tra due valute, puoi utilizzare la mutazione createExchangeRate tramite la nostra GraphQL API. createExchangeRate supporta un codice valuta source e target, oltre a un tipo di rate. La documentazione completa sulla mutazione createExchangeRate può essere trovata nella nostra riferimento API GraphQL. I tassi di cambio recuperati con la nostra API sono specifici per l'organizzazione.

Mutazione

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation {
  exchangeRateCreate(
    input: {
      sourceCurrencyCode: GBP
      targetCurrencyCode: EUR
      type: MID_MARKET
    }
  ) {
    id
    rate
    sourceCurrencyCode
    targetCurrencyCode
  }
}

Risposta

1
2
3
4
5
6
7
8
9
10
{
  "data": {
    "createExchangeRate": {
      "id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
      "rate": 0.6391,
      "sourceCurrencyCode": "GBP",
      "targetCurrencyCode": "EUR"
    }
  }
}

Recupera un tasso di cambio esistente rate

Puoi utilizzare la query exchangeRate con un ID fornito per recuperare i dettagli del tasso di cambio rate precedentemente ottenuti. Questo è utile se desideri vedere i dettagli storici del tasso di cambio rate, utilizzarli per report, interfacce utente, ecc. Puoi vedere un elenco completo dei campi disponibili nella documentazione dell'API GraphQL.

I tassi precedentemente creati non vengono aggiornati quando li recuperi, sono fissati nel tempo al momento in cui sono stati originariamente ottenuti.

Mutazione

1
2
3
4
5
query {
  exchangeRate(id: "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616") {
    // Field names here...
  }
}

Risposta

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "data": {
    "exchangeRate": {
      "id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
      "rate": 0.6391,
      "sourceCurrencyCode": "CAD",
      "targetCurrencyCode": "GBP",
      "targetFormat": {
        "decimalDelimiter": ".",
        "symbol": "£",
        "thousandsDelimiter": ","
      }
    }
  }
}

Tassi di cambio di Google vs tassi di cambio di Zonos 

Quando si utilizza Google per i tassi di cambio, si otterrà un valore diverso da quello fornito dalla nostra API. Il tasso di cambio rate che il tuo cliente vede online non è un tasso di cambio rate per i consumatori. Se cerchi su Google l'attuale conversione da USD a GBP rate, quello che vedrai è il tasso di cambio "benchmark" rate. Questo è il tasso rate a cui le grandi banche internazionali scambiano centinaia di milioni di dollari, ma nessuno può acquistare a questo tasso rate. Un consumatore vedrà questo tasso di cambio benchmark rate più le commissioni addebitate dalla compagnia di cambio valuta quando i tassi di cambio di Zonos non sono utilizzati.

Gli altri siti che vedi molto probabilmente mostrano il tasso di cambio rate per comodità, ma in realtà non stanno addebitando al cliente nella loro valuta estera. Le compagnie di carte di credito e le banche che emettono la carta addebiteranno commissioni di cambio estero e commissioni per transazioni estere ai clienti che acquistano da siti che addebitano in USD. Anche se mostrano la valuta in GBP (o qualsiasi altra valuta), l'importo mostrato loro al momento del checkout non è l'importo che il cliente pagherà effettivamente.

Come accennato in precedenza, offriamo un tasso di cambio rate garantito. Le commissioni aggiuntive che addebitiamo tengono conto del mercato di cambio costantemente fluttuante. È probabile che si verifichino variazioni durante il periodo garantito di 90 giorni per il tasso rate originariamente ottenuto. Le commissioni extra assicurano che l'importo mostrato e pagato dal cliente al momento del checkout sia il costo totale e finale che pagheranno—senza commissioni nascoste o sorprese in seguito.

Questa pagina è stata utile?