Integrationen und API

QrX verbindet Ihren Shop über eine gemeinsame Schicht mit Zahlungsanbietern und Zustellnetzen. Sie können sich über eine fertige Plattformintegration anbinden oder direkt auf der QrX API aufbauen. Beides bringt Ihr Unternehmen in denselben QrX-Ablauf für Zahlung und Zustellung, und Sie müssen Ihren bestehenden Shop nicht ersetzen.

Verfügbare Integrationen

Das Integrationsverzeichnis auf qrx.eu/integrations führt derzeit:

Shopify (Commerce): Die QrX Shopify-App bringt Ihre Shopify-Bestellungen, den Zahlungsstatus und Zustellinformationen in denselben Workflow und markiert Bestellungen als bezahlt, wenn der Kunde an der Tür bezahlt. Siehe den Artikel "QrX für Shopify".
Stripe (Zahlungen): Stripe wickelt die Zahlung über Ihr eigenes Stripe-Konto ab. QrX koordiniert Zahlungsanforderung und Bestätigung mit dem Zustellweg.
MultiSafepay (Zahlungen): Nutzen Sie MultiSafepay für die Zahlungsabwicklung, während QrX den Zahlungsstatus mit der Zustellung verbindet.
UPS (Zustellung): QrX ist der offizielle UPS Payment on Delivery-Partner in Europa und kann UPS-Etiketten erstellen. Siehe den Artikel "UPS Payment on Delivery mit QrX".

Mollie ist ebenfalls ein integrierter Zahlungsanbieter für QrX Payment on Delivery. Verfügbare Zahlungsmethoden, Länder und Versanddienstleistungen hängen immer von Ihrem Anbieterkonto, Ihren Zielmärkten und der QrX-Konfiguration ab. Ist Ihre Plattform, Ihr PSP, Ihr Versanddienstleister oder Ihr Paketstationsnetz nicht aufgeführt, fragen Sie es über die Integrationsseite an oder buchen Sie eine Demo.

Entwickeln mit der öffentlichen QrX API

Stil: REST mit JSON, Basis-URL https://api.qr-x.net, OpenAPI-Spezifikation verfügbar.
Authentifizierung: Erstellen Sie in PortalX unter Settings, Merchant channels (Einstellungen, Händlerkanäle) einen API-Schlüssel pro Vertriebskanal. Tauschen Sie ihn mit POST /api/v1/auth/token gegen ein kurzlebiges Bearer-Token (eine Stunde gültig).
Transaktionen: Erstellen Sie eine Payment on Delivery-Transaktion, rufen Sie deren Details oder Zahlungsstatus ab, markieren Sie sie mit Tracking-Daten als versendet oder stornieren Sie sie.
Referenzdaten: Rufen Sie Versanddienstleister, Länder, Locales, Versandmethoden und Absenderadressen ab.
Produkte und Retouren: Verwalten Sie Ihren Produktkatalog und bearbeiten Sie Retourenanfragen.
Lagerbestand: Bestände, Bestandsartikel und Lagerplätze lesen, eine Bestandskorrektur buchen und die Ereignisse stock/adjusted und stock/low empfangen. Siehe "Bestands- und Lager-API" und "Bestands- und Lager-Webhooks".
Webhooks: Abonnieren Sie Ereignisse, verifizieren Sie signierte Zustellungen, prüfen Sie das Zustellprotokoll, stellen Sie erneut zu und rotieren Sie Signaturgeheimnisse.
Testmodus: Erstellen Sie Transaktionen mit testMode: true, um den gesamten Ablauf ohne echte Zahlungen oder Auszahlungen zu testen.
QrX Connect (OAuth): Plattformen wie Apps, WMS-Systeme oder individuelle Shops können einen Händler einen QrX-Kanal verknüpfen lassen, ohne einen API-Schlüssel einzufügen.

Die vollständige, stets aktuelle Referenz mit Codebeispielen (cURL, Node.js, C#, PHP, Python) und einer fertigen Postman-Collection finden Sie unter qrx.eu/api. Beginnen Sie mit dem Artikel "Entwickler-Schnellstart: öffentliche QrX API und Webhooks".

Zuverlässigkeit von Webhooks

Webhooks sind die maßgebliche Quelle für den endgültigen Transaktionsstatus, da die Zahlungsabwicklung abgeschlossen werden oder fehlschlagen kann, nachdem Ihre Erstellungsanfrage bereits beantwortet wurde. Webhook-Abonnements in PortalX zeigen einen Integritätsstatus. Schlägt ein Endpunkt dauerhaft fehl, warnt QrX die konfigurierten Empfänger per E-Mail und deaktiviert das Abonnement nach etwa 24 Stunden ununterbrochener Fehler automatisch, damit es repariert und wieder aktiviert werden kann. Jeder Webhook hat ein Zustellprotokoll, das jeden Versuch, Anfrage und Antwort sowie Wiederholungen zeigt.

Händlerkanäle

Ein Händler kann in QrX mehrere Vertriebskanäle betreiben. Jeder API-Schlüssel gehört zu einem Kanal, und alles, was damit erstellt wird (Transaktionen, Etiketten, Webhooks), bleibt mit diesem Kanal verbunden. Verwenden Sie pro Kanal einen eigenen Schlüssel.

Support für Entwickler

Wenn Sie den Support wegen eines API- oder Webhook-Problems kontaktieren, geben Sie Zeitpunkt der Anfrage, Umgebung (Test oder Live), Händlerkanal, Bestellreferenz, Transaktions-ID, Webhook-Zustellungs-ID, Antwortstatus sowie einen bereinigten Request- oder Response-Body an. Senden Sie niemals API-Schlüssel, Zugriffstokens oder Webhook-Geheimnisse per Chat oder E-Mail. Siehe auch "Fehlerbehebung bei API und Webhooks".

Verwandte Artikel