Netzwerke und Token

Wählen Sie vor dem Erstellen einer Rechnung oder Einzahlung ein Netzwerk und einen Token aus der API. Der Name des Tokens allein reicht nicht aus: Die Anfrage benötigt seine Adresse in diesem Netzwerk.

Verfügbare Netzwerke abrufen

curl 'https://platform.invoise.me/api/v1/networks'

Verwenden Sie diese Felder aus jedem Netzwerk:

Feld	Zweck
chain_id	Netzwerk-ID.
family	solana oder tron für diese Netzwerke; fehlt oder evm für EVM-Netzwerke.
tokens[].address	Token-Adresse: ein Contract bei EVM und Tron, ein Mint bei Solana.
tokens[].decimals	Anzahl der Dezimalstellen.
tokens[].status	Bereitschaft, falls vorhanden. Verwenden Sie ready-Assets für echte Zahlungen.
minimum_payment	der kleinste Rechnungsbetrag in diesem Netzwerk, in ganzen Token.

Der öffentliche Katalog beschreibt konfigurierte Netzwerke. Ein Händler kann eine kleinere aktivierte Auswahl haben; prüfen Sie GET /api/v1/merchants/{merchant_id}/networks mit einer Sitzung während der Einrichtung. Die API lehnt das Erstellen von Rechnungen oder Einzahlungen in einem nicht verfügbaren Netzwerk oder Asset ab.

Solana und Tron benötigen einen für den Shop festgelegten Empfänger vor der ersten Rechnung. Siehe Solana und Tron.

Netzwerke und Token ändern sich über die Plattformeinstellungen. Lesen Sie Verfügbarkeit, Adressen und Dezimalstellen bei der Auswahl eines Assets aus der API; pflegen Sie keine feste Liste.

Mindestzahlung

minimum_payment ist eine ganze Zahl von Token, zum Beispiel "1". Eine Rechnung darunter gibt 400 amount_below_minimum zurück. Beide Netzwerklisten geben diesen Wert zurück. Der Wert unterscheidet sich zwischen Netzwerken und kann sich ändern, lesen Sie ihn also aus, statt ihn fest im Code zu hinterlegen.

Betrag formatieren

Zahlungsbeträge sind Strings ganzer Zahlen in den kleinsten Einheiten des Tokens:

Token-Dezimalstellen	10 Token in der Anfrage
6	"10000000"
18	"10000000000000000000"

Senden Sie nicht "10.5". Bei 6 Dezimalstellen sind 10,5 Token "10500000". Verwenden Sie Ganzzahlarithmetik (BigInt in JavaScript) für API-Beträge; Gleitkommazahlen können an Genauigkeit verlieren.

Eine Ausnahme: Eine Rechnung, die mehrere Token oder Netzwerke anbietet, nimmt einen dezimalen Token-Betrag entgegen, wie "10.5". Siehe mehrere Token oder Netzwerke.

Gebühren und Auszahlungsschwellen abrufen

curl 'https://platform.invoise.me/api/v1/shops/{shop_id}/terms' \
  -H 'Authorization: Bearer ivk_...'

Die Antwort listet Bedingungen pro Netzwerk auf:

Feld	Zweck
invoice und deposit	Gebühreneinstellungen: bps, minimum, maximum.
sweep_threshold	wie viel eine Einzahlung benötigt, bevor eine Auszahlung geplant wird.
minimum_sweep und maximum_sweep	der angegebene Bereich für diese Einstellung.

bps bedeutet Hundertstel eines Prozents: 50 bps = 0,5 %. minimum und maximum der Gebühr verwenden Einheiten mit achtzehn Dezimalstellen, unabhängig von den Token-Dezimalstellen; 10000000000000000 bedeutet eine Gebühr von 0,01 Token. sweep_threshold ist ein menschenlesbarer Token-Betrag, wie "1".

Die maximale Gebühr ist nicht der maximale Zahlungsbetrag. Halten Sie Gebühren, Rechnungsbeträge und Einzahlungsschwellen getrennt.