Naar de hoofdinhoud

Integraties en API

Overzicht van de API- en webhook-integraties van QrX, webhook-betrouwbaarheid, verkoopkanalen en ondersteuning voor ontwikkelaars.

Geschreven door Hayko

Integraties en API

QrX ondersteunt webwinkels en platforms die Payment On Delivery willen automatiseren via API- en webhook-integraties. Integraties kunnen orders met betaalmogelijkheid aanmaken, statuswijzigingen ontvangen en de betaalbevestiging van QrX koppelen aan bezorg- en supportprocessen.

Wat u kunt integreren

  • Orders aanmaken met contactgegevens van de klant, bedrag, valuta, referentie van de webwinkel en bezorgreferentie.

  • Betaalstatus inclusief de statussen aangemaakt, in behandeling, betaald, mislukt, verlopen, geannuleerd en terugbetaald.

  • Trackinggegevens wanneer uw bezorgsysteem of vervoerder trackingreferenties levert.

  • Verificatie van klantcontactgegevens voor e-mail, telefoon, WhatsApp en SMS-terugvalscenario's.

  • Terugbetalingsprocessen waar dit door uw betaalprovider en configuratie wordt ondersteund.

  • Verzendlabels voor webwinkels met een vervoerderskoppeling, waaronder het aanmaken van UPS-labels via de API.

  • Webhooks voor gebeurtenissen rond betalingen, orders en bezorging.

Betrouwbaarheid van webhooks

Webhook-abonnementen in PortalX tonen een gezondheidsstatus. Als een endpoint blijft falen, waarschuwt QrX de ingestelde ontvangers per e-mail en schakelt het abonnement na ongeveer 24 uur aanhoudende fouten automatisch uit, zodat het hersteld en opnieuw ingeschakeld kan worden. Elke webhook heeft een afleveringslog in PortalX met elke poging, het verzoek en het antwoord, en de nieuwe pogingen, zodat integratieproblemen zonder contact met support gediagnosticeerd kunnen worden.

Kanalen van webwinkels

Een webwinkel kan meerdere kanalen of klantaccounts in QrX beheren. Zorg ervoor dat elk API-verzoek de juiste identificatie van webwinkel, klant, kanaal of account bevat die uw integratie vereist. Zo blijven betalingen, supportgesprekken en trackinggegevens gekoppeld aan de juiste bedrijfscontext.

Ondersteuning voor ontwikkelaars

Vermeld bij contact met support over een API- of webhook-probleem het tijdstip van het verzoek, de omgeving, de webwinkel of het kanaal, de orderreferentie, het transactie-id, het webhook-event-id, de responsstatus en een opgeschoonde request- of response-body. Stuur geen geheime sleutels via chat of e-mail.

UPS- en vervoerdersprocessen

QrX is de enige UPS Payment On Delivery-partner in Europa. In aanmerking komende UPS-processen kunnen QrX gebruiken om digitale betaling te innen voordat een pakket wordt overhandigd, afhankelijk van de configuratie van de webwinkel en de beschikbaarheid bij de vervoerder.

Was dit een antwoord op uw vraag?