Direkt in den Checkout: eine Shopify Payments App für Paypercut
- Entwicklung öffentlicher Apps
- Shopify Payments App
- Fintech
Jede Shopify-App kann eine Storefront verändern. Nur sehr wenige dürfen den Zahlungsschritt anfassen. Wir haben für Paypercut eine Payments App gebaut, sie durch Shopifys Payments-Review gebracht und im Shopify App Store veröffentlicht.
- 30
- EWR-Länder, in denen Käufer Paypercut im Checkout sehen
- 5
- Zahlungsvorgänge: Verkauf, Autorisierung, Capture, Storno und Erstattung
- 15
- Onboarding-Fehler, jeder mit eigener Meldung und nächstem Schritt
- 0
- Webhooks, die der Händler von Hand einrichten muss
- Kunde
- Paypercut, Sofia
- Plattform
- Shopify Payments App
- Leistung
- Öffentliche App, Payments-Review, Launch
- Live
- 10. August 2026, Shopify App Store
Der am besten geschützte Screen auf Shopify
Paypercut ist eine europäische Zahlungsplattform aus Sofia. Händler erhalten einen Checkout für Karten, digitale Wallets und mehrere Buy-Now-Pay-Later-Anbieter, mit Auszahlungen in Landeswährung auf das Bankkonto, das sie bereits haben. Das Versprechen ist einfach: in ganz Europa verkaufen, ohne den Checkout für jeden Markt neu zu bauen.
Für viele europäische Händler heißt „Ihr Checkout“ Shopify. Paypercut musste also dort erscheinen, wo es am meisten zählt: in der Liste der Zahlungsarten im Shopify-Checkout selbst, neben allen anderen Bezahlmöglichkeiten.
Das ist schwieriger, als es klingt. Shopify erlaubt Zahlungsanbietern nicht, Skripte in den Checkout einzubinden. Ein Anbieter muss Shopify Payments Partner werden, eine eigene Payments App auf Basis der Payments Apps API von Shopify bauen, ein Review bestehen, das deutlich strenger ist als das übliche App-Store-Review, und danach mit echtem Geld arbeiten, ohne jeden Spielraum für verlorene oder doppelt belastete Bestellungen.
Unser Auftrag war, diese App für Paypercut zu bauen. Ein Händler sollte sie installieren, einen Schlüssel einfügen und sofort eine Testzahlung durchführen können. Ein Käufer sollte vom Shopify-Checkout zu Paypercut und zurück wechseln, ohne den Übergang zu bemerken. Und jede Zahlung, jedes Capture, jedes Storno und jede Erstattung sollte in beiden Systemen den richtigen Status erreichen, jedes Mal.
So haben wir die App gebaut, das Shopify-Review durchlaufen und sie im Shopify App Store veröffentlicht.
Teil 1: Der Weg des Käufers, zu Paypercut und zurück
Den Checkout zu verlassen, fühlt sich riskant an
Paypercut erfasst Kartendaten auf einer eigenen gehosteten Seite. So bleiben die Kartendaten vollständig außerhalb von Shopify und außerhalb der Reichweite des Händlers. Der Haken ist die Übergabe. Jede Weiterleitung weg vom Checkout ist ein Moment, in dem Käufer zögern, und jede Störung auf dem Rückweg kann eine Bestellung bezahlt, aber unbestätigt zurücklassen.
Eine Offsite Payments Extension mit sauberem Hin- und Rückweg
Wir haben Paypercut als Offsite Payments Extension umgesetzt. Im Checkout sehen Käufer in 30 EWR-Ländern die Option „Mit Karte bezahlen“ mit den Logos von Visa und Mastercard, direkt in der nativen Zahlungsliste von Shopify. Die Demo oben auf dieser Seite zeigt den gesamten Ablauf.
- 01Die ÜbergabeKlickt der Käufer auf „Jetzt bezahlen“, ruft Shopify unsere App auf, und die App erstellt für genau diese Zahlung eine gehostete Paypercut-Checkout-Session. E-Mail-Adresse und Sprache des Käufers werden übergeben, sodass die Paypercut-Seite vorausgefüllt und in seiner Sprache öffnet.
- 02Die ZahlungDer Käufer gibt seine Karte auf der Paypercut-Seite ein, mit 3-D Secure, wo die Bank es verlangt.
- 03Die RückkehrPaypercut leitet den Käufer zurück zu unserer App. Die App bestätigt die Zahlung und weist Shopify an, die Bestellung abzuschließen. Der Käufer landet auf Shopifys eigener Danke-Seite.
Die Psychologie: Vertrauenstransfer. Der Käufer beginnt in einem Checkout, dem er bereits vertraut, wählt eine Zahlungsart, die nativ aussieht, und endet auf der Bestätigungsseite desselben Checkouts. Der Schritt bei Paypercut liegt zwischen zwei vertrauten Screens, und das Vertrauen überträgt sich darauf.
Teil 2: Der Weg des Händlers, von der Installation zur ersten Testzahlung
Bei der Zahlungseinrichtung geben Händler auf
Die meisten Zahlungsintegrationen verlangen, dass Händler Schlüssel kopieren, Webhooks konfigurieren und Einstellungen in zwei Dashboards umschalten. Jeder zusätzliche Schritt ist eine Gelegenheit, das Falsche einzufügen und aufzugeben.
- Schlüssel zwischen zwei Dashboards kopieren
- Webhooks von Hand konfigurieren
- Einstellungen an zwei Stellen umschalten
- Jeder zusätzliche Schritt eine Gelegenheit, das Falsche einzufügen und aufzugeben
- Sandbox- und Live-Schlüssel nebeneinander, auf einer Seite
- Fehlermeldungen, die sagen, was schiefging und was zu tun ist
- Ein Status-Banner, das Lücken erklärt
- Keinerlei Webhook-Konfiguration
Zwei Schlüssel, klare Fehler, keine Webhook-Einrichtung
Die gesamte Einrichtung erledigt der Händler auf einer Seite:
- Sandbox- und Live-Schlüssel nebeneinander. Händler können mit einem Sandbox-Schlüssel starten, während Paypercut ihr Unternehmen prüft, und den Live-Schlüssel später hinzufügen. Der Testmodus von Shopify entscheidet, welcher der zwei Schlüssel für eine Zahlung verwendet wird. Händler testen also genau so, wie Shopify es ihnen beibringt.
- Fehlermeldungen, die sagen, was zu tun ist. Für jeden Fehler, den wir vorhersehen konnten, haben wir eine eigene Meldung geschrieben, 15 insgesamt: ein Publishable Key statt eines Secret Keys, ein Live-Schlüssel im Sandbox-Feld, ein abgelaufener Schlüssel oder ein Schlüssel ohne Zahlungsberechtigungen. Jede Meldung sagt dem Händler, was schiefgelaufen ist, und verlinkt auf die richtige Stelle im Paypercut-Dashboard.
- Ein Status-Banner, das Lücken erklärt. Ist nur ein Sandbox-Schlüssel hinterlegt, weist die Seite darauf hin, dass Live-Zahlungen abgelehnt werden, bis der Live-Schlüssel ergänzt ist. Ist nur ein Live-Schlüssel hinterlegt, heißt es, dass Zahlungen im Testmodus fehlschlagen.
- Keine Webhook-Konfiguration. Sobald ein Schlüssel gespeichert ist, registriert die App im Hintergrund ihren eigenen Paypercut-Webhook-Endpunkt für diesen Modus.
Die Psychologie: Wiedererkennen statt Erinnern. Der Händler muss sich nicht merken, welcher Schlüssel welcher ist. Die Felder sagen „Beginnt mit sk_test_“ und „Beginnt mit sk_live_“, und die Fehlermeldung benennt genau den Schlüssel, den er eingefügt hat.
Teil 3: Der Maschinenraum, damit das Geld stimmt
Zwei Systeme müssen sich bei jedem Cent einig sein
Shopify und Paypercut führen jeweils einen eigenen Datensatz zu jeder Zahlung. Netzwerke verlieren Anfragen, Käufer schließen Tabs, und Shopify wiederholt Aufrufe, bei denen es sich nicht sicher ist. Die App muss beide Datensätze synchron halten, ohne jemals doppelt abzubuchen oder eine Bestellung hängen zu lassen.
Idempotente Sessions und zwei Wege zur Bestätigung
- Eine Shopify-Session, eine Paypercut-Session. Die Session-ID von Shopify ist der Idempotenzschlüssel für den Paypercut-Checkout. Fragt Shopify zweimal, antwortet Paypercut mit derselben Session, statt eine zweite anzulegen.
- Zweimal bestätigen, einmal auflösen. Kehrt der Käufer zurück, fragt die App bei Paypercut den Status der Zahlung ab und wiederholt die Abfrage, solange sie noch aussteht. Parallel sendet Paypercut einen signierten Webhook. Jeder Webhook wird verifiziert, dedupliziert und atomar übernommen. Welche Bestätigung zuerst eintrifft, löst die Zahlung auf, die zweite ändert nichts mehr.
- Captures, Stornos und Erstattungen aus dem Shopify-Admin. Jeder der fünf Vorgänge hat seine eigene State Machine (nicht verarbeitet, in Verarbeitung, verarbeitet). Eine wiederholte Erstattungsanfrage kann also nie doppelt erstatten. Händler können Zahlungen auch nur autorisieren und später einziehen. Die App übergibt das Ablaufdatum der Autorisierung von Paypercut an Shopify, sodass die Bestellung anzeigt, wann die Reservierung ausläuft.
- Mutual TLS an den Zahlungsendpunkten. Shopify legt bei jedem Zahlungsaufruf ein Client-Zertifikat vor, und nur diese Endpunkte sind hinter einer Zertifikatsprüfung erreichbar.
Teil 4: Durch das Review in den Produktivbetrieb
Shopifys Payments-Review
Payments Apps durchlaufen ein eigenes Review, und das ist gründlich. Zu dem Feedback, das wir umgesetzt haben, gehörte: die Zugangsdaten eines Händlers bei der Deinstallation löschen, Händler nach dem Speichern ihrer Schlüssel direkt zurück zu den Paypercut-Einstellungen in Shopify leiten und jede Fehlermeldung so klar formulieren, dass man danach handeln kann. Nach der erneuten Einreichung ging Paypercut am 10. August 2026 im Shopify App Store live.
Gebaut für den Betrieb in einem Zahlungsunternehmen
Paypercut ist ein reguliertes Zahlungsunternehmen. Die App musste sich also in deren Plattform einfügen, nicht umgekehrt. Wir haben eng mit den Engineers von Paypercut zusammengearbeitet, die die Kubernetes-Infrastruktur betreiben, auf der die App läuft.
- Release-Pipeline: Merges werden in eine Dev-Umgebung deployt, getaggte Releases gehen über Staging in die Produktion. Die Shopify-Extension wird über einen eigenen Workflow aus demselben Tag ausgeliefert.
- Security-Hardening: Gateway-Fehler werden protokolliert, Käufern aber nie angezeigt. Das Schlüsselformular antwortet auf einen ungültigen Schlüssel und auf einen Schlüssel eines anderen Shops gleich, sodass sich damit keine Schlüssel ausprobieren lassen. Container-Images werden vor jedem Release gescannt und bereinigt.
- Shopifys neueste Vorgaben: Als Shopify ablaufende Offline-Access-Tokens einführte, wurde die App so umgestellt, dass sie Tokens vor dem Ablauf erneuert. Kein Zahlungsaufruf scheitert an einem veralteten Token.
Eine neue Zahlungsart, nativ in Shopify
Paypercut wollte, dass europäische Shopify-Händler sie so hinzufügen können wie jeden anderen Zahlungsanbieter. Genau so funktioniert es jetzt.
- Nativ im Checkout, in 30 EWR-Ländern„Mit Karte bezahlen“ steht in Shopifys eigener Zahlungsliste, mit einem Abstecher auf die gehostete Paypercut-Seite, den Käufer kaum bemerken.
- Onboarding in EigenregieHändler fügen einen Schlüssel ein und führen Testzahlungen durch, ohne Gespräch, ohne Entwickler und ohne Webhook-Einrichtung.
- Jeder Vorgang genau einmalVerkäufe, Autorisierungen, Captures, Stornos und Erstattungen bleiben zwischen Shopify und Paypercut synchron, auch wenn Anfragen wiederholt werden.
- Freigegeben und livePaypercut hat Shopifys Payments-Review bestanden und ist im Shopify App Store gelistet.
Die beste Zahlungsintegration ist die, über die niemand nachdenkt. Der Käufer bezahlt, der Händler versendet, und das Geld ist da, wo es hingehört.
- Shopify Payments App
- Payments Apps API
- Offsite Payments Extension
- Node
- Remix
- Polaris-Admin
- Mutual TLS
- Signierte, deduplizierte Webhooks
- State Machines pro Vorgang
- Kubernetes
- Dev, Staging, Produktion
Sie möchten diese Art von Arbeit für Ihren Shop?
Schicken Sie uns die URL und was den Shop ausbremst. Wir sehen uns den Shop an, bevor wir antworten.