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
Abschnitt betitelt „Verfügbare Netzwerke abrufen“curl 'https://platform.invoise.me/api/v1/networks'Nur für Preise gibt GET /api/v1/pricing die Gebühren, mit denen ein neuer Händler in jedem Netzwerk startet, den Empfehlungsrabatt und die Kartenpreise in Dollar zurück. Der Endpunkt braucht keine Zugangsdaten, jede Website darf ihn aufrufen, und die Antwort wird fünf Minuten zwischengespeichert.
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 während der Einrichtung mit einer Sitzung oder einem Shop-API-Schlüssel mit read (die Händler-ID des Schlüssels steht in GET /api/v1/me). 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
Abschnitt betitelt „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
Abschnitt betitelt „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.
Standardgebühren
Abschnitt betitelt „Standardgebühren“Das sind die allgemeinen Gebühren, mit denen ein neuer Händler startet; sie können sich von Händler zu Händler unterscheiden, lesen Sie Ihre daher aus der API (unten). Die Gebühr beträgt 0,5 % jeder Rechnung oder jeder Auszahlung einer Einzahlung, nie weniger als die Mindestgebühr des Netzwerks und nie mehr als $10. Das Minimum deckt das Gas Ihrer Auszahlung.
| Netzwerk | Gebühr | Mindestgebühr | Höchstgebühr | Mindestzahlung |
|---|---|---|---|---|
| Ethereum | 0,5 % | $1 | $10 | $10 |
| Arbitrum | 0,5 % | $0,05 | $10 | $1 |
| Base | 0,5 % | $0,03 | $10 | $1 |
| Optimism | 0,5 % | $0,03 | $10 | $1 |
| Polygon | 0,5 % | $0,05 | $10 | $1 |
| BNB Chain | 0,5 % | $0,05 | $10 | $1 |
| Avalanche | 0,5 % | $0,02 | $10 | $1 |
| Solana | 0,5 % | $1 | $10 | $2 |
| Tron | 0,5 % | $4,50 | $10 | $10 |
Zum Beispiel kosten $100 auf Base $0,50, $4 die Mindestgebühr von $0,03 und $5.000 nur $10 statt $25.
Ein Händler, der sich über einen Empfehlungslink registriert hat, startet mit 0,49 %. Ein Händler behält die Gebühren, mit denen er angelegt wurde, und Invoise kann individuelle Gebühren festlegen; lesen Sie daher die Bedingungen Ihres Shops wie unten gezeigt aus der API.
Gebühren und Auszahlungsschwellen abrufen
Abschnitt betitelt „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". Um ihn zu ändern, senden Sie PATCH /api/v1/shops/{shop_id} mit {"sweep_thresholds":{"<chain_id>":"25"}}, innerhalb von minimum_sweep und maximum_sweep dieses Netzwerks; ein Wert außerhalb gibt 400 invalid_sweep_threshold zurück.
Die maximale Gebühr ist nicht der maximale Zahlungsbetrag. Halten Sie Gebühren, Rechnungsbeträge und Einzahlungsschwellen getrennt.