DOCS

Retrieve an exchange rate

/

Wechselkurse abrufen

Erfahren Sie, wie Sie einen Wechselkurs abrufen.

Zonos unterstützt das Abrufen von aktuellen Wechselkursen zwischen zwei Währungen über unsere GraphQL-API. Wir garantieren die Wechselkurse, die wir zwischen Währungen berechnen. Obwohl wir unsere Kurse alle 10 Minuten aktualisieren, garantieren wir den rate ab dem Zeitpunkt der Abfrage für 90 Tage.

Zonos garantiert Wechselkurse nur in Fällen, in denen wir internationale Zahlungen abwickeln, wie über Zonos Checkout oder benutzerdefinierte Integrationen mit unserer Zonos Payments API. Für vollständige Details darüber, wie wir Wechselkurse garantieren, konsultieren Sie unsere Nutzungsbedingungen.

Ein neues Wechselkursobjekt erstellen

Um einen frischen Wechselkurs zwischen zwei Währungen abzurufen, können Sie die Mutation createExchangeRate über unsere GraphQL-API verwenden. createExchangeRate unterstützt einen source und target Währungscode sowie einen rate Typ. Die vollständige Dokumentation zur Mutation createExchangeRate finden Sie in unserem GraphQL API-Referenz. Über unsere API abgerufene Wechselkurse sind organisationsspezifisch.

Mutation

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
  }
}

Antwort

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"
    }
  }
}

Abrufen eines bestehenden rate

Sie können die exchangeRate-Abfrage mit einer bereitgestellten ID verwenden, um zuvor abgerufene rate-Details abzurufen. Dies ist nützlich, wenn Sie historische rate-Details einsehen möchten, sie für Berichte, Benutzeroberflächen usw. verwenden möchten. Eine vollständige Liste der verfügbaren Felder finden Sie in der GraphQL API-Referenz.

Früher erstellte Kurse werden nicht aktualisiert, wenn Sie sie abrufen; sie sind zeitlich auf den Zeitpunkt fixiert, zu dem sie ursprünglich abgerufen wurden.

Mutation

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

Antwort

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": ","
      }
    }
  }
}

Google-Wechselkurse vs. Zonos-Wechselkurse 

Wenn Sie Google für Wechselkurse verwenden, erhalten Sie einen anderen Wert als den, den unsere API bereitstellt. Der Wechselrate, den Ihr Kunde online sieht, ist kein Verbraucherrate. Wenn Sie den aktuellen USD-zu-GBP-Umrechnungsrate googeln, sehen Sie den „Benchmark“-Wechselrate. Dies ist der rate, zu dem große internationale Banken Hunderte von Millionen Dollar tauschen, aber niemand kann zu diesem rate kaufen. Ein Verbraucher sieht diesen Benchmark-Wechselrate zuzüglich der von der Devisenfirma erhobenen Gebühren, wenn Zonos-Wechselkurse nicht verwendet werden.

Die anderen Websites, die Sie sehen, zeigen höchstwahrscheinlich den Wechselrate der Einfachheit halber an, aber sie berechnen dem Kunden nicht tatsächlich in ihrer Fremdwährung. Kreditkartenunternehmen und Banken, die die Karte ausstellen, erheben Fremdwährungs- und Auslandstransaktionsgebühren von Kunden, die auf Websites kaufen, die in USD berechnen. Auch wenn sie die Währung in GBP (oder einer anderen Währung) anzeigen, ist der Betrag, der ihnen beim checkout angezeigt wird, nicht der Betrag, den der Kunde letztendlich zahlen wird.

Wie bereits erwähnt, bieten wir einen garantierten Wechselrate. Die zusätzlichen Gebühren, die wir erheben, berücksichtigen den ständig schwankenden Devisenmarkt. Schwankungen sind wahrscheinlich während des 90-tägigen Garantiezeitraums für den ursprünglich abgerufenen rate. Die zusätzlichen Gebühren stellen sicher, dass der Betrag, der dem Kunden beim checkout angezeigt und von ihm bezahlt wird, die Gesamtkosten sind, die er zahlen wird—keine versteckten oder überraschenden Gebühren später.

War diese Seite hilfreich?