ADR-0007 — Review Provider: Kiyoh¶
| Status | Accepted |
| Date | 2025 |
| Deciders | Flooris development team / Zwerfkei management |
Context¶
Customer reviews are an important trust signal for the Zwerfkei storefront. A solution is needed to collect, moderate and display product and shop reviews, while complying with Dutch consumer review regulations.
Decision¶
Kiyoh is adopted as the external review platform for collecting and displaying customer reviews.
Rationale¶
- Kiyoh is an established Dutch review platform, well-known and trusted by Dutch consumers.
- Kiyoh is already in use within the existing Zwerfkei business.
- Kiyoh provides a verified review process, ensuring reviews come from actual customers.
- An API is available for both sending review invitations and retrieving published reviews.
- Kiyoh review widgets and ratings can be embedded in the storefront.
Integration Pattern¶
| Direction | Description |
|---|---|
| Zwerfkei → Kiyoh | After an order is delivered, the Zwerfkei Backend sends a review invitation request to Kiyoh with the customer's email and order details. |
| Kiyoh → Zwerfkei | Published reviews are fetched via the Kiyoh API and cached locally for display in the storefront. |
Consequences¶
- The Zwerfkei Backend must implement a Kiyoh API client.
- Review invitations must only be sent to customers who have given consent for marketing communications, or are contractually entitled to receive transactional review requests.
- Review moderation and management are handled exclusively within the Kiyoh dashboard; no moderation interface is required in the Zwerfkei back office.
- Local caching of review data reduces dependency on Kiyoh availability and improves storefront performance.