Skapa ett nytt växlings rate-objekt
För att hämta en färsk växlings rate mellan två valutor kan du använda createExchangeRate-mutationen via vår GraphQL-API. createExchangeRate stöder en source och target valutakod, samt en rate-typ. Fullständig dokumentation för createExchangeRate-mutationen finns på vår GraphQL API-referens. Växlingskurser hämtade med vårt API är organisationsspecifika.
Mutation
mutation {
exchangeRateCreate(
input: {
sourceCurrencyCode: GBP
targetCurrencyCode: EUR
type: MID_MARKET
}
) {
id
rate
sourceCurrencyCode
targetCurrencyCode
}
}
Svar
{
"data": {
"createExchangeRate": {
"id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
"rate": 0.6391,
"sourceCurrencyCode": "GBP",
"targetCurrencyCode": "EUR"
}
}
}
Hämta en befintlig växelkurs rate
Du kan använda exchangeRate-frågan med ett angivet ID för att hämta tidigare hämtade växelkurs rate-detaljer. Detta är användbart om du vill se historiska växelkurs rate-detaljer, använda dem för rapporter, användargränssnitt osv. Du kan se en fullständig lista över tillgängliga fält i GraphQL API-referensen.
Tidigare skapade kurser uppdateras inte när du hämtar dem, de är fastställda i tiden till när de ursprungligen hämtades.
Mutation
query {
exchangeRate(id: "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616") {
// Field names here...
}
}
Svar
{
"data": {
"exchangeRate": {
"id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
"rate": 0.6391,
"sourceCurrencyCode": "CAD",
"targetCurrencyCode": "GBP",
"targetFormat": {
"decimalDelimiter": ".",
"symbol": "£",
"thousandsDelimiter": ","
}
}
}
}
Google växelkurser vs Zonos växelkurser
När du använder Google för växelkurser får du ett annat värde än vad vår API tillhandahåller. Växel rate som din kund ser online är inte en konsument rate. Om du googlar den aktuella USD till GBP konverteringen rate, vad du kommer att se är den “benchmark” utländska växelkursen rate. Detta är den rate vid vilken stora internationella banker växlar hundratals miljoner dollar, men ingen kan köpa till denna rate. En konsument kommer att se denna benchmark rate plus avgifter som tas ut av det utländska växlingsföretaget när Zonos växelkurser inte används.
De andra sidorna du ser visar troligen växel rate för bekvämlighetens skull, men de tar faktiskt inte betalt av kunden i deras utländska valuta. Kreditkortsföretag och banker som utfärdar kortet kommer att ta ut växlings- och utlandsavgifter till kunder som köper från sidor som tar betalt i USD. Även om de visar valutan i GBP (eller någon annan valuta), är beloppet som visas för dem vid checkout inte det belopp som kunden slutligen kommer att betala.
Som nämnts tidigare erbjuder vi en garanterad växel rate. De extra avgifter vi tar ut täcker den ständigt fluktuerande växelkursmarknaden. Variationer kan inträffa under den 90-dagars garanterade perioden för den ursprungligen hämtade rate. De extra avgifterna säkerställer att det belopp som visas och betalas av kunden vid checkout är den totala och slutliga kostnaden de kommer att betala—inga dolda eller överraskande avgifter senare.
Hämta växlingskurser
Lär dig hur du hämtar en växlings rate.Zonos stöder hämtning av aktuella växlingskurser mellan två valutor via vår GraphQL-API. Vi garanterar de växlingskurser vi beräknar mellan valutor. Även om vi uppdaterar våra kurser var tionde minut, garanterar vi rate från den tidpunkt den hämtades i 90 dagar.
Zonos garanterar endast växlingskurser för fall där vi hanterar internationella betalningar, till exempel via Zonos Checkout eller anpassade integrationer med vår Zonos Payments API. För fullständiga detaljer om hur vi garanterar växlingskurser, se våra Användarvillkor.