Skapa ett nytt växlingsrate objekt
För att hämta en ny växlingsrate mellan två valutor kan du använda createExchangeRate mutation via vår GraphQL API. createExchangeRate stöder en source och target valutakod, samt en rate typ. Fullständig dokumentation kring createExchangeRate mutation finns i vår GraphQL API-referens. Växlingskurser hämtade med vår 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äxlingsrate.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 10:e 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, såsom genom 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.