Op deze pagina
Tonen jullie de sterren-widget op de bedankpagina van de webshop, dan kunnen jullie hem een ordertoken meegeven in data-order. Dan krijgt de review van de klant het label Geverifieerde aankoop.
Zo werkt het
- De klant rondt een aankoop af.
- Jullie server maakt een ordertoken op basis van het ordernummer en jullie API-sleutel.
- De bedankpagina toont de sterren-widget met het token in data-order.
- De klant schrijft zijn review, en wij controleren het token.
Het token moet op de server worden gemaakt, zodat niemand het in de browser kan vervalsen. Zet de API-sleutel nooit in de code van de website.
Opbouw
Het token bestaat uit vier delen, gescheiden door punten: de prefix uit de sleutel, het ordernummer in base64url, de tijd in Unix-seconden en een handtekening.
De handtekening is de HMAC-SHA256 in base64url van de tekst order-token, de prefix, het ordernummer en de tijd, gescheiden door punten, met het geheim uit de sleutel.
Onder Instellingen, API en webhooks in het dashboard vinden jullie Ordertoken voor de sterren-widget met kant-en-klare voorbeelden in Node.js en PHP.
Goed om te weten
- Het token is 90 dagen geldig.
- Is de bestelling geannuleerd of terugbetaald, dan levert het token het label niet op.
- Is het token ongeldig, dan wordt de review toch opgeslagen, alleen zonder het label.
Als het niet werkt
- Het label verschijnt niet: Controleer of het token is gemaakt met een actieve sleutel en niet ouder is dan 90 dagen.
- Trekken jullie de sleutel in, dan werken tokens die ermee zijn gemaakt niet meer.
Zie ook Geverifieerde aankoop.