Schnellstart

1. Das Produkt erkunden#

Öffnen Sie den Demo-Arbeitsbereich, um eine Testbestellung zu erstellen, Zahlungslinks zu erkunden und eine Gebührenberechnung zu prüfen. Die Demo verwendet separate Testdaten. Sie erstellt keine Bankzahlung und überweist keine Gelder auf eine Geldbörse.

2. Ein Konto mit Telegram erstellen#

Nach der Telegram-Anmeldung öffnet sich das Händlerkonto. Das Website-Onboarding befindet sich unter /account#applications; sowohl das Formular als auch die individuelle Nachverfolgung unter /account#applications/{id} bleiben innerhalb der App.

Eine neue Zahlung und Kartenabsicht erfordern, dass der neueste Website-Review-Antrag des Händlers genehmigt wurde. Die Genehmigung allein verbindet das Zahlungsgateway nicht. Wenn die Überprüfung nach dem Versand geändert wird, bleibt der bestehende Vorgang für Statusabfragen, Abgleich und einen angefragten Bankcode verfügbar.

3. Ihren Shop einrichten#

1. 1

   Wählen Sie einen Shopnamen, den Ihr Kunde wiedererkennen wird.

2. 2

   Wählen Sie eine Standard-Mehrwertsteuerregel. Jede neue Rechnung akzeptiert separat Kunden- und MwSt-Anteile von 0 bis 100 %.

3. 3

   Wählen Sie die Benachrichtigungen, die Sie in Telegram erhalten möchten.

4. 4

   Verwenden Sie den Rechner, um einen typischen Bestellbetrag zu prüfen.

4. Einen Zahlungslink vorbereiten#

Geben Sie einen klaren Bestelltitel, einen Betrag und eine Währung ein. Der Kunde erhält eine eigene Seite mit Kaufdetails und dem fälligen Gesamtbetrag. Eine bestehende Rechnung behält ihre ursprünglichen Bedingungen, wenn sich Ihre Shopeinstellungen ändern.

5. Zahlungsverfügbarkeit prüfen#

Verwalten Sie Rechnungen, API-Schlüssel, Widgets und Webhooks von Ihrem Konto aus. Vor der Zahlung prüft Kevmi die Gateway-Konfiguration, die Händlergenehmigung, den Betrag und die Rechnungsbedingungen. Wenn die gewählte Methode nicht verfügbar ist, erklärt der Checkout warum.

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.

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.