Tällä sivulla
Jos näytätte tähti-widgetin verkkokaupan kiitossivulla, voitte antaa sille tilaustunnisteen attribuutissa data-order. Silloin asiakkaan arvostelu saa merkin Vahvistettu ostos.
Näin se toimii
- Asiakas tekee oston.
- Palvelimenne luo tilaustunnisteen tilausnumerosta ja API-avaimestanne.
- Kiitossivu näyttää tähti-widgetin, jonka data-order-attribuutissa on tunniste.
- Asiakas kirjoittaa arvostelunsa, ja me tarkistamme tunnisteen.
Tunniste on luotava palvelimella, jotta kukaan ei voi väärentää sitä selaimessa. Älkää koskaan laittako API-avainta verkkosivun koodiin.
Rakenne
Tunniste koostuu neljästä pisteellä erotetusta osasta: avaimen etuliite, tilausnumero base64url-muodossa, aika Unix-sekunteina ja allekirjoitus.
Allekirjoitus on HMAC-SHA256 base64url-muodossa tekstistä order-token, etuliitteestä, tilausnumerosta ja ajasta pisteillä erotettuina, avaimen salaisuudella.
Hallintapaneelin kohdasta Asetukset, API ja webhookit löydätte kohdan Tilaustunniste tähti-widgetille valmiine esimerkkeineen Node.js:lle ja PHP:lle.
Hyvä tietää
- Tunniste on voimassa 90 päivää.
- Jos tilaus on peruttu tai hyvitetty, tunniste ei anna merkkiä.
- Jos tunniste on virheellinen, arvostelu tallennetaan silti, mutta ilman merkkiä.
Jos se ei toimi
- Merkkiä ei tule: Tarkistakaa, että tunniste on luotu aktiivisella avaimella ja että se ei ole yli 90 päivää vanha.
- Jos perutte avaimen, sillä luodut tunnisteet eivät enää toimi.
Katsokaa myös Vahvistettu ostos.