Erste Schritte mit Ihrem eigenen Webshop oder System
Dieser Leitfaden richtet sich an Händler, die über einen anderen Webshop als Shopify verkaufen (zum Beispiel WooCommerce, Magento, Lightspeed oder einen individuellen Shop) oder ein eigenes Bestellsystem betreiben und QrX Payment on Delivery sowie Versandetiketten nutzen möchten. Ihr System sendet Bestellungen über die QrX Public API an QrX, oder Sie importieren sie aus einer Tabelle. Der Kunde schließt den Checkout ab, ohne zu bezahlen, scannt an der Tür den QrX QR-Code auf dem Paket und bezahlt über Ihren eigenen Zahlungsanbieter.
In PortalX ist das der Einrichtungsweg Ich verkaufe über einen anderen Webshop oder mein eigenes System im Leitfaden Erste Schritte (Einstellungen > Geschäft > Erste Schritte).
1. Richten Sie Ihr Unternehmen ein
Vervollständigen Sie Ihre Unternehmensdaten. QrX übernimmt Firmenname, Adresse und USt-IdNr. oder Handelsregisternummer aus Ihrer Registrierung. Wenn etwas fehlt oder sich geändert hat, klicken Sie im Schritt auf QrX fragen, und QrX vervollständigt die Angaben für Sie. Der Schritt wird abgehakt, sobald alle Angaben bekannt sind.
Fügen Sie Ihr Lager als Absenderadresse hinzu unter Einstellungen > Betrieb > Adressen. Geben Sie ihr einen kurzen Code: Ihr System verwendet diesen Code in API-Aufrufen.
Verbinden Sie Ihren Zahlungsanbieter (Stripe, Mollie oder MultiSafePay) im Tab Zahlungen des Kanals.
2. Versand einrichten
Verbinden Sie einen Versanddienstleister unter Einstellungen > Betrieb > Versanddienstleister und fügen Sie Methodenprofile hinzu. Jedes Methodenprofil hat einen Code für API-Aufrufe.
Schließen Sie Ihren Etikettendrucker an unter Einstellungen > Einstellungen > Druck (PrintNode), oder lassen Sie Ihr eigenes System die Etiketten drucken, die QrX zurückgibt.
Erstellen Sie eine Versandregel unter Einstellungen > Betrieb > Versandregeln. Für API-Bestellungen können Sie festlegen, dass Regeln angewendet werden.
3. Ihr System mit der API verbinden
Kopieren Sie den API-Schlüssel Ihres Kanals. Einstellungen > Geschäft > Händlerkanäle, Kanal öffnen, Tab Einstellungen, API-Schlüssel neu generieren (Regenerate API Key). QrX speichert den Schlüssel gehasht, er wird also nur einmal vollständig angezeigt: Speichern Sie ihn auf Ihrem Server, nie in einem Browser oder einer App. Klicken Sie im Schritt auf Als erledigt markieren (Mark as done), sobald Sie ihn haben.
Holen Sie sich Ihr erstes Zugriffstoken. POST /api/v1/auth/token mit dem Header QrX-MerchantChannel-API-Key. Das Token ist 3600 Sekunden gültig.
Erstellen Sie Ihre erste Testtransaktion. POST /api/v1/transactions mit dem Betrag, den Bestelldaten und, wenn Sie im selben Aufruf ein Etikett möchten, einem Paketblock mit Ihren Methoden- und Absendercodes. Verwenden Sie zuerst den Testmodus. HTTP 201 bedeutet, dass QrX die Bestellung angenommen hat, nicht, dass sie bezahlt ist.
Webhooks abonnieren. Einstellungen > Erweitert > Webhooks, oder POST /api/v1/webhooks. Mindestens Transaktion bezahlt, storniert und Sendung versendet. Prüfen Sie bei jeder Zustellung den Header X-QrX-Signature.
Erhalten Sie Ihren ersten Webhook. Verwenden Sie Test senden (Send Test) im Webhook-Editor und prüfen Sie die Zustellprotokolle (Delivery Logs).
Die vollständige Referenz mit Codebeispielen finden Sie unter qrx.eu/api. Siehe auch "Schnellstart für Entwickler: QrX Public API und Webhooks".
Bestellungen ohne Entwickler erstellen
Dieser Weg zeigt auch die Schritte, um Bestellungen in PortalX zu erstellen, nützlich zum Testen oder wenn Sie noch keinen Entwickler haben:
Eine Transaktion von Hand erstellen: Transaktionen > Transaktion erstellen (Create Transaction).
Bestellungen aus einer Tabellenkalkulation importieren: Verwenden Sie unter Transaktionen das Menü Importieren (Import) mit einem CSV- oder Excel-Export aus Ihrem Shop. Versandregeln werden auf importierte Bestellungen angewendet.
Fügen Sie Ihre Produkte hinzu unter Produkte > Katalog, damit Bestellpositionen schneller ausgefüllt werden (optional).
4. Halten Sie Ihre Kunden auf dem Laufenden
Gestalten Sie Ihre Track & Trace Seite im eigenen Markendesign: Einstellungen > Betrieb > Track & Trace.
Passen Sie Ihre Kundennachrichten an: Einstellungen > Betrieb > Vorlagen.
Aktivieren Sie SMS-Zustellungsbenachrichtigungen (optional, kostenpflichtig, standardmäßig ausgeschaltet): Händlerkanäle, Kanal öffnen, Tab Einstellungen, SMS.
Öffnen Sie Ihr Message Centre: Einstellungen > Betrieb > Message Centre.
5. Bezahlung an der Tür
Führen Sie eine Testzahlung an der Tür durch, indem Sie den QR-Code auf einem Testetikett scannen. Das kostet nichts.
Verlangen Sie optional eine PIN auf der Zahlungsseite.
Bitten Sie QrX über Mit QrX chatten um den Livegang.
Ihre erste Live-Zahlung an der Tür hakt den letzten Schritt ab.
Tipps für eine saubere Integration
Senden Sie Ihre eigene Shop-Bestellnummer mit, damit Sie Bestellungen in beiden Systemen wiederfinden.
Betrachten Sie Webhooks als maßgebliche Quelle für bezahlt und storniert; eine Zahlung kann lange nach der Antwort auf Ihren Erstellungsaufruf abgeschlossen werden.
Verwenden Sie die Referenz-Endpunkte (/api/v1/reference/carriers, shipping-methods, senders) statt fest codierter IDs.
Nutzen Sie einen Händlerkanal pro Webshop: Jeder Kanal hat seinen eigenen API-Schlüssel, Zahlungsanbieter und sein eigenes Branding.
Wann Sie unser Support-Team kontaktieren sollten
Kontaktieren Sie den QrX Support, wenn Token-Anfragen mit einem gültigen Schlüssel wiederholt fehlschlagen, wenn Webhooks nach wiederholten Fehlern deaktiviert wurden und Sie die Ursache nicht finden, oder wenn Sie bereit für den Livegang sind.