Zum Hauptinhalt springen

Einführung

Mit der Merchant API von Volet.com kann Ihre Anwendung Krypto-Zahlungen akzeptieren, Auszahlungen und Transfers senden, Transaktionen verfolgen und Kontodaten abrufen, etwa Guthaben, Tarife und Limits.

Schritt-für-Schritt-Szenarien finden Sie in den Anleitungen: API-Integration für die Zahlungsannahme und API-Integration für Massenauszahlungen.

Basis-URL​

https://api.volet.com

Alle Endpunkte sind relativ zu dieser URL, zum Beispiel https://api.volet.com/api/account/balances.

Bevor Sie beginnen​

  • Ein verifiziertes Volet.com-Konto, Personal oder Business.
  • Eine API, die Sie im Bereich der Zahlungstools Ihres Kontos erstellt haben, mit den Berechtigungen, die Ihre Integration braucht. Siehe Zahlungs-Gateway erstellen oder Massenauszahlungen aktivieren.
  • Die IP-Adressen Ihrer Server in der IP-Whitelist der API.

Volet.com bietet keine Sandbox. Testen Sie Ihre Integration mit kleinen Live-Transaktionen.

Authentifizierung​

Jede Anfrage enthält drei Header:

HeaderWert
Api-NameDer Name der API in Ihrem Volet.com-Konto
Account-EmailDie E-Mail-Adresse des Volet.com-Kontos, dem die API gehört
Authentication-TokenEin SHA-256-Token, erzeugt aus Ihrem API-Passwort und dem aktuellen Datum und der Stunde in UTC

Authentifizierungstoken erzeugen​

  1. Bilden Sie die Zeichenkette password:YYYYMMDD:HH, wobei password Ihr API-Passwort ist und Datum und Stunde in UTC angegeben werden.
  2. Berechnen Sie den SHA-256-Hash der Zeichenkette.
  3. Senden Sie den Hash als hexadezimale Zeichenkette im Header Authentication-Token. Die API unterscheidet nicht zwischen Groß- und Kleinschreibung; üblich sind Kleinbuchstaben.

Zum Beispiel für das Passwort MySecret123 am 26. Oktober 2026 um 14:00 Uhr UTC:

SHA256("MySecret123:20261026:14")

ergibt:

c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd

Der Token ändert sich jede Stunde (UTC). Erzeugen Sie ihn direkt vor jeder Anfrage. Die API akzeptiert auch die Token der vorherigen und der nächsten Stunde, sodass eine Anfrage zum Stundenwechsel oder von einem Server mit leicht abweichender Uhr nicht abgelehnt wird.

Im Bereich Try it jeder Methode können Sie Ihr API-Passwort eingeben und das Token im Browser erzeugen. Das Passwort wird nirgendwohin gesendet.

Passwort auf dem Server aufbewahren

An die API wird nur das Token gesendet, nie das Passwort. Legen Sie API-Passwort und Tokens nicht in Frontend-Code, mobilen Apps, Bots oder anderen clientseitigen Skripten ab.

Anfrageformat​

  • Anfragen und Antworten verwenden JSON über HTTPS. Senden Sie bei Anfragen mit Body Content-Type: application/json.
  • Beträge sind Dezimalzahlen, zum Beispiel "amount": 100. Die API akzeptiert sie auch als Zeichenketten, etwa "amount": "100.00". Die Zahl der Nachkommastellen hängt von der Währung ab.
  • Stablecoin-Codes enthalten das Netzwerk, wo Guthaben über eine Blockchain geht, zum Beispiel USDT_TRC20; Wallet-Währungen haben keins, etwa USDT. Siehe Währungscodes und Beträge.

Beispielanfrage:

curl https://api.volet.com/api/account/balances \
-H "Api-Name: my-api" \
-H "Account-Email: [email protected]" \
-H "Authentication-Token: c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd"

Anfragelimit​

Für Privatkonten und für Geschäftskonten ohne abgeschlossene Verifizierung begrenzt die API die Zahl der Anfragen pro Stunde. Ist das Limit ausgeschöpft, gibt die API HTTP 401 mit dem Fehler attemptsHaveEndedException zurück. Warten Sie und senden Sie die Anfrage später. Verifizierte Geschäftskonten haben dieses stündliche Limit nicht.