Zum Inhalt springen

API

Auf dieser Seite

Unterstützte Währungen

Prüfen, welche der 13 Blockchain-Netzwerke USDT, USDC, USD1, DAI und das goldgedeckte XAUT unterstützen, bevor Sie Assets in einem Projekt aktivieren.

Felder der Anfrage

currency ist ein einheitliches öffentliches API-Feld. Es kann entweder einen Fiat-Währungscode wie USD oder ein Krypto-Kürzel wie USDT enthalten.

Für Rechnungen in Fiat senden Sie currency ohne network:

{
  "amount": "100.00",
  "currency": "USD"
}

Für direkte Krypto-Rechnungen und für Auszahlungen senden Sie currency zusammen mit network:

{
  "amount": "50.00",
  "currency": "USDT",
  "network": "TRC20"
}

Auszahlungen gibt es nur in Krypto-Assets. Auszahlbar ist jedes Asset, in dem Sie ein Guthaben halten. Die Matrix unten zeigt allerdings die Annahme, und für die Auszahlung ist die Auswahl kleiner: NEAR und SUI nehmen nur ein und lassen sich nicht als Ziel angeben. Bleiben elf Netzwerke — welches davon in Frage kommt, hängt weiter vom Asset ab.

network — beim Anlegen einer direkten Krypto-Rechnung oder einer Auszahlung geben Sie currency zusammen mit network an:

{
  "currency": "USDT",
  "network": "TRC20"
}

Gültige Werte für network bei einer Rechnung: TRC20, ERC20, BEP20, POLYGON, ARBITRUM, OPTIMISM, BASE, TON, AVAX, SOL, NEAR, SUI, PLASMA. Bei einer Auszahlung dieselbe Liste ohne NEAR und SUI.

Preismodell

Bei Preisen in Fiat (currency = USD/EUR/…) fixiert Paymos den Wechselkurs in dem Moment, in dem der Kunde im gehosteten Checkout Token und Netzwerk wählt. Der Kunde zahlt dann den entsprechenden Token-Betrag. Der fixierte Kurs wird an der Rechnung als payment.exchange_rate zurückgegeben.

Bei direkten Krypto-Preisen (currency = USDT/USDC/… mit network) zahlt der Kunde exakt den Betrag in diesem Token in diesem Netzwerk. Es gibt keine Umrechnung.

Die Gutschrift erfolgt immer in dem Asset, mit dem der Kunde gezahlt hat. Paymos wandelt Krypto nie in Fiat um: Sie zahlen dasselbe Asset auf Ihr eigenes Wallet aus, und einen Umtausch in Fiat organisieren Sie selbst, außerhalb von Paymos.

Fiat-Währungen

Gruppe Codes
Leitwährungen USD, EUR, GBP, CHF, CAD, AUD, NZD, JPY
Europa PLN, CZK, DKK, SEK, NOK, HUF
GUS RUB, UAH, GEL
Asien CNY, HKD, KRW, INR, IDR, MYR, PHP, THB, VND, PKR, SGD, BDT, LKR, MMK, TWD
Amerika BRL, MXN, ARS, CLP, BMD, VEF
Naher Osten / Afrika TRY, AED, ILS, NGN, ZAR, BHD, KWD, SAR

Token

Token Kürzel Netzwerke
Tether USD USDT TRC20, ERC20, BEP20, POLYGON, ARBITRUM, OPTIMISM, TON, AVAX, SOL, NEAR, PLASMA
USD Coin USDC ERC20, BEP20, POLYGON, ARBITRUM, OPTIMISM, BASE, AVAX, SOL, NEAR, SUI
Tether Gold XAUT ERC20
Dai DAI ERC20
World Liberty USD USD1 ERC20, SOL

Netzwerke

Paymos wartet die für das Netzwerk angemessene Finalität ab, bevor eine Zahlung gutgeschrieben wird. Auf den Chains, die Blöcke zählen, skaliert die erforderliche Tiefe mit dem USD-Betrag der Zahlung — kleine Zahlungen bestätigen schnell, große warten länger. Chains mit schneller nativer Finalität — heute BNB Smart Chain, Polygon, Solana, Avalanche und Plasma — nutzen statt einer Blockzahl das Finalitätskennzeichen der Chain. Die genauen Bestätigungstiefen, und auf welcher Seite dieser Linie eine Chain steht, sind betrieblich und können sich ohne Ankündigung ändern; der für eine Zahlung angewandte Wert kommt in den API-Antworten als required_confirmations zurück und ist null, wenn die Chain über Finalität statt über eine feste Blockzahl bestätigt.

Netzwerk Code Typ
Tron TRC20 L1
Ethereum ERC20 L1
BNB Smart Chain BEP20 L1
Polygon PoS POLYGON L1
Arbitrum One ARBITRUM L2
Optimism OPTIMISM L2
Base BASE L2
TON TON L1
Avalanche AVAX L1
Solana SOL L1
NEAR NEAR L1
Sui SUI L1
Plasma PLASMA L1

Matrix aus Token und Netzwerk

Nicht jedes Krypto-Asset ist in jedem Netzwerk verfügbar. Die Tabelle unten zeigt alle gültigen Kombinationen:

TRC20 ERC20 BEP20 POLYGON ARBITRUM OPTIMISM BASE TON AVAX SOL NEAR SUI PLASMA
USDT Ja Ja Ja Ja Ja Ja -- Ja Ja Ja Ja -- Ja
USDC -- Ja Ja Ja Ja Ja Ja -- Ja Ja Ja Ja --
XAUT -- Ja -- -- -- -- -- -- -- -- -- -- --
DAI -- Ja -- -- -- -- -- -- -- -- -- -- --
USD1 -- Ja -- -- -- -- -- -- -- Ja -- -- --