Naar de hoofdinhoud

Aan de slag als softwareplatformpartner

Hoe softwareplatforms eenmalig koppelen met QrX Connect, zodat hun webwinkels QrX Payment on Delivery met een paar klikken kunnen inschakelen.

H
Geschreven door Hayko

Aan de slag als softwareplatformpartner

Deze gids is voor bedrijven die software bouwen die door veel webwinkels wordt gebruikt, zoals een WMS, een winkelplatform, een orderbeheersysteem of verzendsoftware, en die QrX Payment on Delivery in hun product willen aanbieden. U koppelt één keer. Elke webwinkel koppelt daarna met een paar klikken het eigen QrX-account aan uw software via QrX Connect, zonder API-sleutels te kopiëren.

In PortalX is dit de inrichtingsroute Ik bouw software en wil mijn klanten koppelen in de Aan de slag-gids (Instellingen > Zakelijk > Aan de slag).

Hoe het werkt

  • Elke webwinkel houdt een eigen QrX-account, betaalprovider en vervoerdersinrichting.

  • De webwinkel klikt in uw software op "Connect QrX", logt in bij QrX, kiest een verkoopkanaal en klikt op Allow (toestaan).

  • Uw server ontvangt de API-sleutel voor dat ene kanaal en roept namens de webwinkel de QrX Public API aan.

  • De betaling van de consument aan de deur blijft altijd op go.qr-x.app. Uw software komt nooit aan de betaling zelf.

1. Richt je bedrijf in

  1. Vul je bedrijfsgegevens aan. QrX bewaart de bedrijfsnaam, het adres en het btw- of KvK-nummer uit uw aanmelding. Ontbreekt er iets of is er iets veranderd, klik dan in de stap op Vraag het aan QrX en QrX vult het voor u aan. De stap wordt afgevinkt wanneer alle gegevens bekend zijn.

  2. Nodig uw ontwikkelaars uit in Instellingen > Team & Toegang > Gebruikers.

2. Vraag je QrX Connect-client-ID aan

Klik in de stap op Vraag het aan QrX (dit opent de chat), of gebruik qrx.eu/api. Geef QrX uw productnaam en uw HTTPS-callback-URL. Elke integratie krijgt een eigen client-ID.

3. Bouw de koppeling

  1. Stuur de webwinkel naar https://portal.qr-x.app/oauth/authorize met uw client-ID, callback-URL, een willekeurige state en een PKCE-challenge (S256).

  2. Controleer op uw callback de state en wissel de code in: POST https://api.qr-x.net/api/v1/oauth/token (authorization_code met code_verifier). De code werkt één keer.

  3. Bewaar de teruggegeven API-sleutel van het kanaal versleuteld op uw server.

  4. Wissel deze in voor een toegangstoken met POST /api/v1/auth/token en roep de API aan zoals bij elke koppeling van een webwinkel.

Details: "QrX Connect: uw platform koppelen met OAuth" en de referentie op qrx.eu/api.

4. Maak een testtransactie aan voor die webwinkel

  1. Koppel een testwebwinkel (uw eigen QrX-account werkt ook) met QrX Connect.

  2. Maak in testmodus een transactie met een label aan: POST /api/v1/transactions.

  3. Abonneer u op webhooks voor dat kanaal en controleer de header X-QrX-Signature.

  4. Scan de QR-code op het testlabel en rond een testbetaling aan de deur af.

5. Certificeer labels en webhooks met QrX

Voordat webwinkels uw koppeling live gebruiken, controleert QrX samen met u de volledige stroom: labeluitvoer op de printers die uw webwinkels gebruiken (PDF of ZPL, UPS Standard- of Extended-label), nieuwe pogingen die nooit een tweede label aanmaken, verwerking van webhooks, en annuleren. Plan dit in de stap via Vraag het aan QrX.

Partnerschap

QrX biedt partnervergoedingen voor activiteit die daarvoor in aanmerking komt. De voorwaarden worden per partnerschap afgesproken; zie "Partners en hoe u partner wordt van QrX".

Wanneer neemt u contact op met ons supportteam

Neem contact op met QrX om een client-ID of callback-URL aan te vragen of te wijzigen, wanneer het inwisselen van het token met een geldige code blijft mislukken, of om de certificering te plannen.

Gerelateerde artikelen
Was dit een antwoord op uw vraag?