Naar de hoofdinhoud

Aan de slag met uw eigen webshop of systeem

Hoe u QrX koppelt aan WooCommerce, Magento, Lightspeed of uw eigen ordersysteem via de QrX Public API of een import, en live gaat met Payment on Delivery.

H
Geschreven door Hayko

Aan de slag met uw eigen webshop of systeem

Deze gids is voor webwinkels die verkopen via een andere webshop dan Shopify (bijvoorbeeld WooCommerce, Magento, Lightspeed of een maatwerkwinkel) of die een eigen ordersysteem hebben, en die QrX Payment on Delivery en verzendlabels willen. Uw systeem stuurt orders naar QrX via de QrX Public API, of u importeert ze vanuit een spreadsheet. De klant rekent af zonder te betalen, scant aan de deur de QrX QR-code op het pakket en betaalt via uw eigen betaalprovider.

In PortalX is dit de inrichtingsroute Ik verkoop via een andere webshop of mijn eigen systeem in de Aan de slag-gids (Instellingen > Zakelijk > Aan de slag).

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. Voeg je magazijn toe als afzenderadres in Instellingen > Bedrijfsvoering > Adressen. Geef het een korte code: uw systeem gebruikt die code in API-aanroepen.

  3. Koppel je betaalprovider (Stripe, Mollie of MultiSafePay) in het tabblad Betalingen van het kanaal.

2. Verzending inrichten

  1. Koppel een vervoerder in Instellingen > Bedrijfsvoering > Vervoerders en voeg methodeprofielen toe. Elk methodeprofiel heeft een code voor API-aanroepen.

  2. Sluit je labelprinter aan in Instellingen > Voorkeuren > Afdrukken (PrintNode), of laat uw eigen systeem de labels printen die QrX teruggeeft.

  3. Maak een verzendregel in Instellingen > Bedrijfsvoering > Verzendregels. Voor API-orders kunt u kiezen of regels worden toegepast.

3. Koppel je systeem met de API

  1. Kopieer de API-sleutel van je kanaal. Instellingen > Zakelijk > Handelaarskanalen, open het kanaal, tabblad Instellingen, API-sleutel opnieuw genereren (Regenerate API Key). QrX slaat de sleutel gehasht op, dus die wordt maar één keer volledig getoond: bewaar hem op uw server, nooit in een browser of app. Klik in de stap op Markeren als gedaan (Mark as done) zodra u hem hebt.

  2. Vraag een toegangstoken aan. POST /api/v1/auth/token met de header QrX-MerchantChannel-API-Key. Het token is 3600 seconden geldig.

  3. Maak je eerste testtransactie aan. POST /api/v1/transactions met het bedrag, de ordergegevens en, als u in dezelfde aanroep een label wilt, een parcel-blok met uw methode- en afzendercodes. Gebruik eerst de testmodus. HTTP 201 betekent dat QrX de order heeft geaccepteerd, niet dat deze is betaald.

  4. Abonneer je op webhooks. Instellingen > Geavanceerd > Webhooks, of POST /api/v1/webhooks. Minimaal transactie betaald, geannuleerd en zending verzonden. Controleer bij elke levering de header X-QrX-Signature.

  5. Ontvang je eerste webhook. Gebruik Test versturen (Send Test) in de webhook-editor en controleer de Delivery Logs (leveringslogboek).

De volledige referentie met codevoorbeelden staat op qrx.eu/api. Zie ook "Snelstart voor ontwikkelaars: QrX Public API en webhooks".

Maak je bestellingen zonder ontwikkelaar

Deze route toont ook de stappen om orders in PortalX aan te maken, handig om te testen of wanneer u nog geen ontwikkelaar hebt:

  • Maak een transactie met de hand aan: Transacties > Transactie aanmaken.

  • Bestellingen importeren vanuit een spreadsheet: gebruik in Transacties het menu Importeren (Import) met een CSV- of Excel-export uit uw winkel. Verzendregels draaien op geïmporteerde orders.

  • Voeg je producten toe in Producten > Catalogus, zodat orderregels sneller worden ingevuld (optioneel).

4. Houd je klanten op de hoogte

  • Geef uw Track and Trace-pagina een eigen uitstraling: Instellingen > Bedrijfsvoering > Track & Trace.

  • Pas je klantberichten aan: Instellingen > Bedrijfsvoering > Sjablonen.

  • Schakel sms-bezorgupdates in (optioneel, betaald, standaard uit): Handelaarskanalen, open het kanaal, tabblad Instellingen, Sms.

  • Open uw Message Centre: Instellingen > Bedrijfsvoering > Message Centre.

5. Word betaald aan de deur

  1. Doe een testbetaling aan de deur door de QR-code op een testlabel te scannen. Dit kost niets.

  2. Vereis desgewenst een pincode op de betaalpagina.

  3. Vraag QrX via Chat met QrX om live te gaan.

  4. Uw eerste live betaling aan de deur vinkt de laatste stap af.

Tips voor een nette koppeling

  • Stuur uw eigen ordernummer uit de winkel mee, zodat u orders in beide systemen terugvindt.

  • Behandel webhooks als de bron van waarheid voor betaald en geannuleerd; een betaling kan lang nadat uw aanmaakaanroep is teruggekomen worden afgerond.

  • Gebruik de referentie-endpoints (/api/v1/reference/carriers, shipping-methods, senders) in plaats van vaste id's.

  • Houd één handelaarskanaal per webshop aan: elk kanaal heeft een eigen API-sleutel, betaalprovider en huisstijl.

Wanneer neemt u contact op met ons supportteam

Neem contact op met QrX-support wanneer tokenaanvragen met een geldige sleutel blijven mislukken, wanneer webhooks na herhaalde fouten zijn uitgeschakeld en u de oorzaak niet vindt, of wanneer u klaar bent om live te gaan.

Gerelateerde artikelen
Was dit een antwoord op uw vraag?