Zahlungslinks
Ein Zahlungslink öffnet eine eigene Bestellseite. Kunden sehen Verkäufer, Kaufbeschreibung, verfügbare Methoden und fälligen Gesamtbetrag auf ihrem Telefon oder Computer.
Auf dieser Seite
Was eine Rechnung enthält#
Neue Workspace-Rechnungen verwenden einen USD-Basispreis, und Any bietet alle vier Methoden an. SBP rechnet zum eingefrorenen Referenzkurs der Bank von Russland in RUB um; Krypto verwendet die explizite 1:1-USD/USDT-Rechnungsregel. Legacy-native Preise bleiben für alte Rechnungen und API-Anfragen ohne pricingMode=universal verfügbar. Siehe Abschnitt zu mehreren Geschäften und USD-Preisen unten.
Geben Sie niemals Passwörter, API-Schlüssel, Kartendaten oder Bankcodes in öffentlichen Beschreibungen an. Verwenden Sie einen Bestelltitel und eine Referenz, die der Kunde erkennt.
- Geschäftsname, ein Bestelltitel von bis zu 120 Zeichen und eine Beschreibung von bis zu 500 Zeichen.
- Grundbetrag und eine explizite Währung USD, RUB oder USDT.
- Kompatible Methoden, getrennte Gebühren- und Mehrwertsteueranteile, eine Bestellreferenz und Link-Ablauf.
- Antworten des Eigentümers enthalten link.payment mit dem gespeicherten Zustand eines bestehenden Vorgangs; dies ist getrennt vom Verfügbarkeitsstatus des Links.
Beliebig – der Kunde wählt#
Beliebig wählt alle Methoden aus, die mit der Rechnungswährung kompatibel sind: Karten und Alipay für USD, SBP für RUB und Krypto für USDT. Die API erwartet ein konkretes Methoden-Array und nicht den String beliebig. Jede Methode hat ihr eigenes Angebot.
Neue Workspace-Rechnungen verwenden einen USD-Basispreis, und Any bietet alle vier Methoden an. SBP rechnet zum eingefrorenen Referenzkurs der Bank von Russland in RUB um; Krypto verwendet die explizite 1:1-USD/USDT-Rechnungsregel. Legacy-native Preise bleiben für alte Rechnungen und API-Anfragen ohne pricingMode=universal verfügbar. Siehe Abschnitt zu mehreren Geschäften und USD-Preisen unten.
Für eine neue Live-Karten- oder Alipay-Zahlung unterstützt das aktuelle Gateway nur feeCustomerPercent=0 und vatCustomerPercent=100: der Händler übernimmt die gesamte Bearbeitungsgebühr und die MwSt wird dem Kunden vollständig hinzugefügt. Andere Anteile können auf einer Rechnung gespeichert und berechnet werden, aber die Ausführung ist mit unsupported_allocation blockiert. Der Server ändert gespeicherte Bedingungen niemals stillschweigend. SBP- und USDT-Kryptozahlungen unterstützen jeden Bearbeitungsgebührenanteil und haben keine MwSt.
Einen Link erstellen#
- 1
Zahlungslink in Ihrem Konto öffnen.
- 2
Geben Sie Titel, Betrag, Währung und Beschreibung ein. Legen Sie Gebühr- und MwSt.-Anteile mit den beiden Reglern fest.
- 3
Lassen Sie Beliebig aktiv, damit der Kunde wählt, oder wählen Sie bestimmte Methoden aus. Legen Sie das Ablaufdatum fest.
- 4
Vergleichen Sie die Gesamtsumme für jede Methode und sehen Sie sich die Kasse in der Vorschau an.
- 5
Erhalten Sie den fertigen Kasselink direkt nach der Erstellung und kopieren Sie ihn für Ihren Kunden oder Ihr Widget.
Bedingungen bleiben bei der Rechnung#
Eine gespeicherte Rechnung ändert sich nicht, wenn sich die Shop-Einstellungen ändern. Ihr Preis, ihre Währung, Gebühr- und MwSt.-Anteile, Bestellreferenz und Metadaten gehören zu dieser Bestellung. Dadurch bleibt die Gesamtsumme für einen Kunden konsistent, der den Link bereits geöffnet hat.
Erstellen Sie einen neuen Link und pausieren Sie den alten, wenn sich Preis, Beschreibung oder Kostenverteilung ändern. Die Bearbeitung eines Betrags kann die Serverberechnung nicht ändern.
Eine eigene Kassenseite#
Serverlinks werden in der Datenbank gespeichert und sind geräteübergreifend unter /pay/… ohne Zugriff auf das Händlerkonto zugänglich. Ein Kunde muss sich nicht registrieren, um eine Rechnung anzusehen. Shop-Guthaben, Einstellungen und andere Kundendatensätze bleiben privat.
Das Beispiel /pay/demo zeigt die Erfahrung, ohne Geld zu belasten. Browser-Demolinks sind Testdaten und dürfen nicht als echte Rechnungen präsentiert werden.
Verfügbarkeit verwalten#
Das Pausieren, Stornieren oder Ablaufen eines Links blockiert einen neuen Vorgang. Es verbirgt nicht eine bereits übermittelte Zahlung: Status, Abstimmung und ein angeforderter Bankcode bleiben verfügbar. Linkverfügbarkeit und Finanzzustand werden getrennt geprüft.
Das Fortsetzen hebt eine Pause auf, ohne die Bedingungen zu ändern. Eine Stornierung ist endgültig, und ein abgelaufener Link kann nicht verlängert werden. Erstellen Sie eine neue Rechnung für eine neue Bestellung oder geänderte Bedingungen, nicht um eine Zahlung erneut zu versuchen, deren Ergebnis unbekannt ist.
Mehrere Geschäfte und ein USD-Basispreis#
Wählen Sie Alle Geschäfte für aggregierte Analysen und Betrieb, oder wählen Sie ein Geschäft für dessen eigene Aufzeichnungen. Jedes Geschäft hat eine separate storeId, einen Namen, einen MwSt-Standardwert, Rechnungen, API-Schlüssel, Webhook-Endpunkte, Ereignisverlauf und Website-Anwendung. Benachrichtigungen und Support-Tickets gehören zum Konto. Ein Konto kann bis zu 100 Geschäfte erstellen. Vorhandene Datensätze verbleiben im ersten Geschäft.
Neue Workspace-Rechnungen verwenden pricingMode="universal" und einen USD-Basispreis. Any umfasst Karte, Alipay, SBP und Krypto; ein Händler kann eine Teilmenge auswählen. Karten und Alipay berechnen USD. SBP berechnet RUB unter Verwendung des USD/RUB-Referenzkurses der Bank von Russland. Krypto berechnet USDT gemäß der expliziten Rechnungsregel 1 USD = 1 USDT. Dies ist eine Rechnungsumrechnungsregel, kein Markt-USDT-Kurs. Das Gateway liefert den Kurs der ausgewählten Münze, den genauen Überweisungsbetrag und Anweisungen vor der Überweisung.
Der Referenzkurs und beide Beträge werden bei der Erstellung eingefroren. Rechnungen mit RUB-Umrechnung verfallen innerhalb von 24 Stunden. Wenn der Referenzkurs nicht abgerufen werden kann, schlägt die Erstellung mit FX_UNAVAILABLE fehl; es wird kein erfundener oder veralteter Ersatzkurs verwendet. Der Basisbetrag Minor und Angebote verwenden die USD-Buchungswährung. quotes[method].settlement enthält das native Belastungsangebot. Der öffentliche Checkout legt die ausgewählte Belastungswährung in currency, den ursprünglichen Preis in baseAmountMinor/baseCurrency und den Referenzkurs in fx offen. Sobald eine Zahlung ausgelöst wurde, kann ihre Methode nicht geändert werden; eine Rechnung hat einen Gateway-Vorgang.
Erstellen Sie einen API-Schlüssel im vorgesehenen Geschäft und senden Sie Authorization: Bearer <key> von Ihrem Server. Seine Geschäftsbindung ist unveränderlich; X-Kevmi-Store kann ihm keinen Zugriff auf ein anderes Geschäft gewähren. Browser-Sitzungen wählen X-Kevmi-Store: <storeId>; wenn es weggelassen wird, wird das erste Geschäft ausgewählt. Der Wert all wird nur von GET /api/account/dashboard und GET /api/payment-links akzeptiert. Mutationen erfordern ein ausgewähltes Geschäft, Origin und X-CSRF-Token. Konto-IDs und Geschäfts-IDs sind unterschiedliche Kennungen.
Aus Kompatibilitätsgründen behalten API-Anfragen ohne pricingMode="universal" native Preise und die ursprünglichen Währungsbeschränkungen bei. Bestehende Rechnungen werden nie neu berechnet. Bestätigte Zahlungseingänge in Analysen spiegeln verifizierte Zahlungen abzüglich gespeicherter Rechnungsausgaben wider; sie sind kein abhebbarer Saldo. Legacy-Rechnungswährungen bleiben getrennt, und Auszahlungen werden mit dem Support vereinbart. Führen Sie eine Bestellung erst aus, nachdem Sie payment.fulfillmentReady=true und payment.status="succeeded" über die Server-API, den Ereignisverlauf oder einen signierten Webhook geprüft haben.