Skip to main content

Reviews

Reviews are customer feedback tied to a merchant and an order. They drive the merchant's rating and are visible to future customers.

Attributes​

  • Rating — 1–5 stars
  • Feedback — free-text comment
  • Response — merchant's public reply
  • Verified — whether the reviewer completed the order

GraphQL​

query {
  listReviews(merchantId: "mer_42") {
    id
    rating
    feedback
    response
    verified
    createdAt
  }
}

mutation {
  createReview(input: {
    merchantId: "mer_42"
    orderId: "ord_789"
    rating: 5
    feedback: "Great coffee, fast delivery!"
  }) {
    id
    rating
  }
}

mutation {
  respondToReview(id: "rev_1", response: "Thank you! See you soon.") {
    id
    response
  }
}

Next steps​