Erste Schritte als Softwareplattform-Partner
Dieser Leitfaden richtet sich an Unternehmen, die Software für viele Händler entwickeln, etwa ein WMS, eine Shop-Plattform, ein Auftragsverwaltungssystem oder Versandsoftware, und QrX Payment on Delivery in ihrem Produkt anbieten möchten. Sie integrieren einmal. Jeder Händler verbindet danach sein eigenes QrX Konto mit wenigen Klicks über QrX Connect mit Ihrer Software, ohne API-Schlüssel zu kopieren.
In PortalX ist das der Einrichtungsweg Ich entwickle Software und möchte meine Händler anbinden im Leitfaden Erste Schritte (Einstellungen > Geschäft > Erste Schritte).
So funktioniert es
Jeder Händler behält sein eigenes QrX Konto, seinen Zahlungsanbieter und seine Einrichtung der Versanddienstleister.
Der Händler klickt in Ihrer Software auf "Connect QrX", meldet sich bei QrX an, wählt einen Vertriebskanal und klickt auf Allow.
Ihr Server erhält den API-Schlüssel für genau diesen Kanal und ruft die QrX Public API im Namen des Händlers auf.
Die Zahlung des Verbrauchers an der Tür bleibt immer auf go.qr-x.app. Ihre Software berührt die Zahlung selbst nie.
1. Ihr eigenes Konto einrichten
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.
Laden Sie Ihre Entwickler unter Einstellungen > Team & Zugang > Benutzer ein.
2. Fordern Sie Ihre QrX Connect-Client-ID an
Klicken Sie im Schritt auf QrX fragen (öffnet den Chat) oder nutzen Sie qrx.eu/api. Nennen Sie QrX Ihren Produktnamen und Ihre HTTPS-Callback-URL. Jede Integration erhält ihre eigene Client-ID.
3. Die Verbindung aufbauen
Leiten Sie den Händler zu https://portal.qr-x.app/oauth/authorize mit Ihrer Client-ID, Callback-URL, einem zufälligen State und einer PKCE-Challenge (S256).
Prüfen Sie in Ihrem Callback den State und tauschen Sie den Code ein: POST https://api.qr-x.net/api/v1/oauth/token (authorization_code mit code_verifier). Der Code funktioniert nur einmal.
Speichern Sie den zurückgegebenen API-Schlüssel des Kanals verschlüsselt auf Ihrem Server.
Tauschen Sie ihn mit POST /api/v1/auth/token gegen ein Zugriffstoken ein und rufen Sie die API wie bei jeder Händlerintegration auf.
Details: "QrX Connect: Ihre Plattform per OAuth verbinden" und die Referenz unter qrx.eu/api.
4. Eine Testtransaktion für Ihren ersten Händler erstellen
Verbinden Sie einen Testhändler (Ihr eigenes QrX Konto funktioniert) mit QrX Connect.
Erstellen Sie eine Transaktion im Testmodus mit Etikett: POST /api/v1/transactions.
Abonnieren Sie Webhooks für diesen Kanal und prüfen Sie den Header X-QrX-Signature.
Scannen Sie den QR-Code auf dem Testetikett und schließen Sie eine Testzahlung an der Tür ab.
5. Mit QrX zertifizieren
Bevor Händler Ihre Integration live nutzen, prüft QrX mit Ihnen den gesamten Ablauf: Etikettenausgabe auf den Druckern Ihrer Händler (PDF oder ZPL, UPS Standard oder Extended Etikett), erneute Versuche, die nie ein zweites Etikett erzeugen, Webhook-Verarbeitung und Stornierung. Buchen Sie das über QrX fragen im Schritt.
Partnerschaft
QrX bietet Partnergebühren für berechtigte Aktivitäten. Die Bedingungen werden pro Partnerschaft vereinbart; siehe "Partner und wie Sie Partner von QrX werden".
Wann Sie unser Support-Team kontaktieren sollten
Kontaktieren Sie QrX, um eine Client-ID oder Callback-URL anzufordern oder zu ändern, wenn der Token-Austausch mit einem gültigen Code wiederholt fehlschlägt oder um die Zertifizierung zu planen.