Zum Inhalt springen

Konzepte

Invoise gibt Ihrem Kunden eine Zahlungsadresse und sendet die erhaltenen Mittel abzüglich der Servicegebühr an Ihre Wallet.

Begriff Bedeutung
Konto Ein Benutzer, der sich bei der Plattform anmeldet und Zugriff auf Händler und Shops erhält.
Händler Ein Unternehmen in Invoise mit eigenen Shops, Team und Bedingungen.
Shop Wo Rechnungen und Einzahlungen erstellt werden. Er hat eigene Empfängereinstellungen, API-Schlüssel und einen Vorgangsverlauf.
Rechnung Eine Anfrage für eine einmalige Zahlung eines festen Betrags. Erstellt über /invoices.
Einzahlung Eine wiederverwendbare Adresse für Aufladungen ohne festen Betrag. Erstellt über /deposits.
Eingehender Transfer Vom Zahlenden an eine Rechnungs- oder Einzahlungsadresse gesendete Mittel. Mehrere Transfers können eine Rechnung bezahlen.
Auszahlung Erhaltene Mittel, die abzüglich der Servicegebühr an den Empfänger des Shops überwiesen werden.

issuance ist der von Rechnungen und Einzahlungen gemeinsam genutzte API-Ressourcenname. Speichern Sie die id aus der Erstellungsantwort als issuance_id für nachfolgende Anfragen.

Verknüpfen Sie eine Bestellung in Ihrem eigenen System über external_id mit einer Rechnung. Die Invoise-Entität ist immer eine Rechnung.

  1. Erstellen Sie eine Rechnung oder Einzahlung.
  2. Warten Sie auf ihre address und geben Sie dem Kunden dann die zurückgegebene payment_url.
  3. Der Kunde sendet den ausgewählten Token im ausgewählten Netzwerk.
  4. Invoise bestätigt den eingehenden Transfer. Sobald genügend Mittel verfügbar sind, sendet es die Auszahlung an Ihren Empfänger.

Sie können den Fortschritt mit einer GET-Anfrage prüfen oder Webhooks empfangen. Siehe Rechnungs- und Einzahlungsstatus.

Eine Rechnung wird funded, sobald genügend bestätigte Mittel eingegangen sind. Der Abschluss der Auszahlung wird separat durch payout.confirmed bestätigt.

Einstellung Zweck
Empfängeradresse Die Wallet, die EVM-Auszahlungen erhält. Prüfen Sie, ob sie Ihre ausgewählten Netzwerke unterstützt.
Invoise-Wallet Statt einer Adresse kann ein Shop in die Invoise-Wallet eines Kontomitglieds zahlen.
Delegierter Eine optionale, von Ihnen kontrollierte Wallet, die EVM-Rechnungen eigenständig abwickeln und Gas bezahlen kann. Eine Börsenadresse ist dafür nicht geeignet.

Sie können den Empfänger, den Delegierten und die Wahl zwischen einer Adresse und der Invoise-Wallet später mit PATCH /shops/{shop_id} ändern. Jede Rechnung und Einzahlung behält den Empfänger und Delegierten, mit dem sie erstellt wurde, sodass eine Änderung nur danach erstellte Rechnungen und Adressen betrifft.

Solana und Tron haben eigene Empfänger. Siehe Solana und Tron.

Die Servicegebühr wird von der Auszahlung abgezogen. Lesen Sie die aktuellen Gebühren und Limits Ihres Shops; berechnen Sie sie nicht anhand einer kopierten Preisliste.

Bei Einzahlungen sammeln sich kleine Zahlungen an, bis die Auszahlungsschwelle erreicht ist. Bei Rechnungen sammeln sich Teilzahlungen an, bis der Rechnungsbetrag erreicht ist. Eine Überzahlung einer Rechnung geht mit der Gebühr an Invoise, nicht an Ihren Empfänger.

Nutzen Sie einen Sandbox-Shop, um die Integration ohne echte Mittel auszuprobieren.