Integrationen
Anbinden, wie es passt: API, gehostete Seiten oder ohne Code
Wählen Sie den Weg, der zu Ihrem Team und Ihrem PCI-Umfang passt: auf der REST-API aufsetzen, einen gehosteten Checkout einbinden, einen Payment Link versenden oder einen Batch im Business Portal hochladen – und Ihr KI-Coding-Tool den echten Vertrag lesen lassen.
- REST-API
- Stage-Sandbox
- Signierte Webhooks
- Öffentlicher MCP-Server
REST-APISieben Wege
Wählen Sie Ihre Anbindung
Hinter jedem Weg stehen dieselben Konten, Salden und Berichte – Sie können schlank starten und später erweitern.
Direkte REST-APIAm flexibelsten
Volle Kontrolle über Pay-ins, Auszahlungen, virtuelle Konten, Devisen und Reporting. JSON über HTTPS, aus Ihrem Backend aufgerufen, mit signierten Webhooks bei jeder Statusänderung.
Direkte REST-API —Gehostetes WebCheckoutOhne Code
Leiten Sie Kunden auf einen von Localpayment gehosteten Checkout mit den lokalen Methoden, die Sie aktivieren. Kein Front-End-Code, den Sie pflegen müssen.
Gehostetes WebCheckout —Payment LinksOhne Code
Erstellen Sie im Business Portal einen Link und teilen Sie ihn per E-Mail, SMS oder Social Media. Ideal für Rechnungen, Fernverkauf und Einmalzahlungen.
Payment Links —Eingebettetes iFrameWhite Label
Binden Sie einen White-Label-Checkout in Ihre eigene Seite ein und behalten Sie Ihre Marke drumherum – bei reduziertem PCI-Umfang.
Eingebettetes iFrame —Smart-Fields-JS-SDKEigenes Formular
Gehostete Kartenfelder werden im Browser tokenisiert und zu einem Einmal-Token zusammengeführt, das Ihr Server anschließend belastet. Das Formulardesign bestimmen Sie.
Smart-Fields-JS-SDK —Batches im Business PortalOperations
Laden Sie Dateien für Auszahlungen und virtuelle Konten hoch und verfolgen Sie die Ergebnisse im Portal. Kein Integrationsaufwand für Finanzen und Operations.
Batches im Business Portal —MCP-Server für KI-ToolsKI-gestützt
Ein öffentlicher, schreibgeschützter MCP-Server und llms.txt lassen Cursor, VS Code, Claude und andere Assistenten gegen die dokumentierte API entwickeln.
MCP-Server für KI-Tools —
Vergleich
Aufwand, PCI-Umfang und Einsatzzweck
Eine Orientierungshilfe für die Vorauswahl. Ihr endgültiger PCI-Umfang hängt davon ab, wie Sie Kartendaten erfassen und speichern; stimmen Sie ihn mit Ihrem Assessor ab.
Direkte REST-API
- Aufwand
- Hoch: Entwicklung im Backend
- PCI-Umfang
- Abhängig von der Erfassung der Kartendaten; kombinierbar mit Smart Fields oder einer gehosteten Option
- Geeignet für
- Plattformen, die Pay-ins, Auszahlungen und Devisen voll kontrollieren wollen
Gehostetes WebCheckout
- Aufwand
- Gering: Weiterleitung
- PCI-Umfang
- Minimal
- Geeignet für
- Teams, die lokale Methoden schnell live schalten wollen
Payment Links
- Aufwand
- Sehr gering: ohne Code
- PCI-Umfang
- Minimal
- Geeignet für
- Rechnungen, Fernverkauf, Einmalzahlungen
Eingebettetes iFrame
- Aufwand
- Gering bis mittel
- PCI-Umfang
- Reduziert
- Geeignet für
- Checkout im eigenen Look ohne Umgang mit Kartenfeldern
Smart-Fields-JS-SDK
- Aufwand
- Mittel: Front-End und Backend
- PCI-Umfang
- Geteilt
- Geeignet für
- Eigenes Checkout-Design mit gehosteten Kartenfeldern
Batches im Business Portal
- Aufwand
- Sehr gering: Datei-Upload
- PCI-Umfang
- Keine Kartendaten beteiligt
- Geeignet für
- Finanzen und Operations für Auszahlungen und virtuelle Konten
MCP-Server für KI-Tools
- Aufwand
- Gering: eine URL hinzufügen
- PCI-Umfang
- Nicht zutreffend: keine Zahlungsdaten
- Geeignet für
- Entwickler mit KI-Coding-Assistenten
Stage-Zugangsdaten (Sandbox) erhalten Sie zu Beginn der Partnerschaft. Der Produktivzugang folgt nach Tests, Sicherheitsprüfung und Unternehmensverifizierung.
Die API in der Praxis
Ein typisches API-Pay-in, durchgängig
Vier Beteiligte, sechs Schritte. Ihr Backend spricht nur mit einer API; die lokale Schiene übernehmen wir.
- 1
Händler-BackendLocalpayment-API:
Authentifizieren
POST /api/token/ liefert ein kurzlebiges Zugriffstoken. Aufrufe kommen aus Ihrem Backend, von einer freigegebenen IP.
- 2
Händler-BackendLocalpayment-API:
Pay-in anlegen
POST /api/payin/ mit Ihrer eigenen externalId, Land, Währung, Betrag und Zahlungsmethode.
- 3
Localpayment-APILokale Schiene:
An lokale Schiene routen
Localpayment sendet die Anfrage über die aktivierte Schiene, etwa Pix, SPEI oder PSE.
- 4
Lokale SchieneLocalpayment-API:
Kunde zahlt
Die Schiene bestätigt die Zahlung. Echtzeit-Schienen bestätigen in Sekunden, rund um die Uhr.
- 5
Localpayment-APIWebhook-Endpunkt:
Signierter Webhook
Ein Webhook mit dem Header X-Signature (HMAC-SHA256) meldet den neuen Status.
- 6
Webhook-EndpunktHändler-Backend:
Prüfen und aktualisieren
Signatur prüfen, nach externalId oder internalId deduplizieren, 200 zurückgeben und die Bestellung aktualisieren.
Vereinfachte Darstellung mit fiktiven Daten. Die genauen Request- und Response-Felder finden Sie im Quickstart.
Live gehen
Vom Vertrag zum Livebetrieb
Stage-Zugangsdaten erhalten
Die Sandbox-Zugangsdaten kommen zu Beginn der Partnerschaft, sodass die Entwicklung startet, während die Compliance-Prüfung läuft.
In Stage entwickeln und testen
Stage spiegelt die Produktion ohne echtes Geld. Nutzen Sie Testkarten, den Simulator für virtuelle Konten und die Postman-Collection.
Prüfung und Verifizierung
Produktivzugangsdaten folgen nach abgeschlossenen Tests, einer Sicherheitsprüfung und der Unternehmensverifizierung.
In Wochen live gehen
Basis-URL und Zugangsdaten wechseln, IPs freigeben und loslegen. Neue Märkte werden per Konfiguration aktiviert, ohne Neuintegration.
FAQ
Fragen zur Integration
Mit welchem Weg sollten wir beginnen?
Wenn Sie Kontrolle brauchen und Entwickler haben, starten Sie mit der REST-API. Wenn lokale Methoden schnell live gehen sollen, nutzen Sie WebCheckout oder Payment Links. Auf demselben Konto lassen sich Wege kombinieren.
Bieten Sie Server-SDKs an?
Es gibt keine offiziellen Server-SDKs. Die REST-API ist reines JSON über HTTPS, die Dokumentation zeigt cURL- und Node.js-Beispiele. Das einzige SDK ist das clientseitige Smart-Fields-JS-SDK.
Wie werden API-Aufrufe abgesichert?
Aufrufe erfolgen per HTTPS aus Server-Umgebungen mit Bearer-Tokens und setzen IP-Freigaben voraus. Webhooks sind mit HMAC-SHA256 signiert, sodass Sie prüfen können, dass sie von Localpayment stammen.
Wie vermeiden wir doppelte Belastungen?
Senden Sie bei jeder Transaktion Ihre eigene eindeutige externalId. Ein Duplikat liefert HTTP 409, und Webhook-Empfänger sollten nach externalId oder internalId deduplizieren.
Wie wirkt sich das auf unseren PCI-Umfang aus?
Das hängt vom Weg ab. Gehostetes WebCheckout und Payment Links halten den Umfang minimal, das eingebettete iFrame reduziert ihn, Smart Fields teilt ihn. Stimmen Sie das Ergebnis mit Ihrem Assessor ab.
Wie helfen KI-Coding-Tools?
Fügen Sie den öffentlichen, schreibgeschützten MCP-Server unter docs.localpayment.com/mcp zu Cursor, VS Code, Claude oder ähnlichen Tools hinzu. Sie lesen dann die dokumentierte API, statt zu raten.
Wie lange dauert die Integration?
Stage-Zugangsdaten kommen zu Beginn der Partnerschaft, der Livegang dauert Wochen – je nach Weg und Ihren Prüfzyklen. Sprechen Sie mit dem Vertrieb über einen Plan für Ihren Fall.
Starten Sie noch heute
Nennen Sie uns Ihre Märkte und Ihren Stack. Wir empfehlen den passenden Integrationsweg und richten Ihre Stage-Zugangsdaten ein.