Integraties en API
QrX verbindt uw webwinkel met betaalproviders en bezorgnetwerken via één gedeelde laag. U kunt koppelen via een kant-en-klare platformintegratie of direct bouwen op de QrX API. Beide brengen uw bedrijf in dezelfde QrX-flow voor betalen en bezorgen, en u hoeft uw bestaande webwinkel niet te vervangen.
Beschikbare integraties
Het integratieoverzicht op qrx.eu/integrations vermeldt momenteel:
Shopify (commerce): de QrX Shopify-app brengt uw Shopify-bestellingen, betaalstatus en bezorginformatie samen in dezelfde workflow, en markeert bestellingen als betaald wanneer de klant aan de deur betaalt. Zie het artikel "QrX voor Shopify".
Stripe (betalingen): Stripe verwerkt de betaling via uw eigen Stripe-account. QrX coördineert het betaalverzoek en de bevestiging met het bezorgtraject.
MultiSafepay (betalingen): gebruik MultiSafepay voor betaalverwerking, terwijl QrX de betaalstatus koppelt aan de bezorging.
UPS (bezorging): QrX is de officiële UPS Payment on Delivery-partner in Europa en kan UPS-labels aanmaken. Zie het artikel "UPS Payment on Delivery met QrX".
Mollie is ook een geïntegreerde betaalprovider voor QrX Payment on Delivery. Beschikbare betaalmethoden, landen en vervoerdersdiensten hangen altijd af van uw provideraccount, bestemmingsmarkten en QrX-configuratie. Staat uw platform, PSP, vervoerder of netwerk van pakketkluizen er niet bij, vraag het dan aan via de integratiepagina of plan een demo.
Bouwen met de openbare QrX API
Stijl: REST met JSON, basis-URL
https://api.qr-x.net, OpenAPI-specificatie beschikbaar.Authenticatie: maak per verkoopkanaal een API-sleutel aan in PortalX onder Settings, Merchant channels (Instellingen, Verkoopkanalen). Wissel deze in voor een kortlevend Bearer-token met
POST /api/v1/auth/token(één uur geldig).Transacties: maak een Payment on Delivery-transactie aan, haal de details of betaalstatus op, markeer deze als verzonden met trackinggegevens, of annuleer deze.
Referentiegegevens: raadpleeg vervoerders, landen, locales, verzendmethoden en afzenderadressen.
Producten en retouren: beheer uw productcatalogus en handel retourverzoeken af.
Magazijnvoorraad: voorraadstanden, voorraadartikelen en locaties lezen, een voorraadcorrectie boeken en de events
stock/adjustedenstock/lowontvangen. Zie "Voorraad- en magazijn-API" en "Voorraad- en magazijnwebhooks".Webhooks: abonneer u op events, verifieer ondertekende leveringen, bekijk het leveringslog, lever opnieuw af en vernieuw ondertekeningsgeheimen.
Testmodus: maak transacties aan met
testMode: trueom de volledige flow te testen zonder echte betalingen of uitbetalingen.QrX Connect (OAuth): platforms zoals apps, WMS-systemen of maatwerkwinkels kunnen een webwinkel een QrX-kanaal laten koppelen zonder een API-sleutel te plakken.
De volledige, altijd actuele referentie met codevoorbeelden (cURL, Node.js, C#, PHP, Python) en een kant-en-klare Postman-collectie staat op qrx.eu/api. Begin met het artikel "Snelstart voor ontwikkelaars: openbare QrX API en webhooks".
Betrouwbaarheid van webhooks
Webhooks zijn de bron van waarheid voor de uiteindelijke transactiestatus, omdat de betaalverwerking kan worden afgerond of mislukken nadat uw aanmaakverzoek al is teruggekeerd. Webhookabonnementen in PortalX tonen een gezondheidsstatus. Blijft een endpoint falen, dan waarschuwt QrX de ingestelde ontvangers per e-mail en schakelt het abonnement automatisch uit na ongeveer 24 uur aanhoudende fouten, zodat het kan worden hersteld en opnieuw ingeschakeld. Elke webhook heeft een leveringslog met elke poging, het verzoek en het antwoord, en herhaalpogingen.
Verkoopkanalen
Een webwinkel kan meerdere verkoopkanalen in QrX gebruiken. Elke API-sleutel hoort bij één kanaal, en alles wat ermee wordt aangemaakt (transacties, labels, webhooks) blijft aan dat kanaal gekoppeld. Gebruik per kanaal een aparte sleutel.
Support voor ontwikkelaars
Vermeld bij contact met support over een API- of webhookprobleem het tijdstip van het verzoek, de omgeving (test of live), het verkoopkanaal, de orderreferentie, het transactie-id, het webhooklevering-id, de responsstatus en een opgeschoonde request- of responsbody. Stuur nooit API-sleutels, toegangstokens of webhookgeheimen via chat of e-mail. Zie ook "Probleemoplossing voor API en webhooks".