Problemen met API en webhooks oplossen
QrX-support voor API en webhooks werkt het beste wanneer verzoeken duidelijke identificatiegegevens en opgeschoonde technische details bevatten.
Veelvoorkomende API-problemen
Verkeerde identificatie van webwinkel, klant of kanaal.
Ontbrekend e-mailadres of telefoonnummer van de klant voor verificatie- en supportprocessen.
Ongeldige configuratie van bedrag, valuta, land of betaalmethode.
Webhook-endpoint niet bereikbaar of een niet-succesvolle respons.
Dubbele orderreferenties of idempotentieproblemen.
Verkeerde omgeving, zoals productiegegevens die naar een testendpoint worden gestuurd.
Wat u naar support stuurt
Stuur de omgeving, de webwinkel of het kanaal, de orderreferentie, het QrX-transactie-id, het tijdstempel, het endpoint, de responsstatus, het webhook-event-id en een opgeschoonde request- of response-body. Verwijder API-sleutels, tokens, handtekeningen, wachtwoorden en persoonsgegevens die niet nodig zijn voor het debuggen.
Controles bij webhook-retries
Controleer of uw endpoint bereikbaar is, snel een succesvolle status teruggeeft, handtekeningen correct valideert en dubbele webhook-gebeurtenissen veilig afhandelt. Webhook-ontvangers moeten idempotent zijn, omdat er nieuwe pogingen kunnen plaatsvinden.
Webhook-gezondheid en afleveringslogs
Elk webhook-abonnement in PortalX toont een gezondheidsstatus. Als een endpoint continu faalt, stuurt QrX waarschuwingsmails naar de ingestelde ontvangers en schakelt het abonnement na ongeveer 24 uur aanhoudende fouten automatisch uit; het kan in PortalX opnieuw worden ingeschakeld nadat het endpoint is hersteld. Gebruik het afleveringslog per webhook in PortalX om elke afleverpoging te bekijken, inclusief het verzoek, de respons en de nieuwe pogingen, voordat u contact opneemt met support.
Wanneer u contact opneemt met ons supportteam
Neem rechtstreeks contact op met QrX-support bij API-problemen die te maken hebben met inloggegevens, beveiliging, productie-incidenten, inconsistenties in betalingen, fouten in webhook-handtekeningen of terugkerende integratiefouten. Deze worden altijd door een medewerker behandeld.