Do I need an API key for order → invite?

Commerce and Pro can use a webhook token URL for storefront order events. Growth/Pro API keys are for POST /api/v1/invites and custom stacks — see https://ranqa.me/developers

Do widgets replace Schema.org AggregateRating?

No. Widgets embed a live score on your storefront. Search engines crawl AggregateRating on your public Ranqa company/product pages when reviews exist.

How long does a typical commerce setup take?

About 15 minutes for ready modules (token + webhook/plugin + test order). Catalog mapping and PDP widget placement may take longer depending on your theme.

← Integrations

Velicoo review invites & widgets

First-class Velicoo module: post-delivery invites, PDP widgets, and catalog sync — configured per tenant in Velicoo Admin.

1. Enable the module

The real module lives in Velicoo. This zip documents setup and the commerce endpoint.

Download Velicoo setup pack (.zip) →

Ranqa Dashboard → create Commerce webhook token or API key.
Velicoo Admin → Integrations → Ranqa → paste token and enable.
Invite delay default 7 days after WMS delivery; disable native review emails.
Pick PDP widget slots and optionally sync catalog.
Send a test invite from Velicoo or Ranqa.

2. Commerce endpoint

InviteWorker posts delivered orders here (EAN line items, country, verified).

POST https://ranqa.me/api/v1/commerce/velicoo/orders?token=YOUR_WEBHOOK_TOKEN
Content-Type: application/json

{
  "email": "[email protected]",
  "name": "Anna",
  "id": "TG12345",
  "line_items": [{ "sku": "7350123456789" }],
  "shipping": { "country": "SE" },
  "delayHours": 0,
  "verifiedPurchase": true
}

# Or: Authorization: Bearer rnq_… (Growth/Pro API key)

Open dashboard setup →

3. Widget slots

Configure in Velicoo Admin — badge and carousel placement on the PDP. Enable the footer slot so the store links back to the public Ranqa page.

below_title — under the product name
below_gallery — under image thumbnails
above_tabs — before description accordion
below_description — after long description
footer — full review section (badge + carousel)

Setup FAQ

Do I need an API key for order → invite?: Commerce and Pro can use a webhook token URL for storefront order events. Growth/Pro API keys are for POST /api/v1/invites and custom stacks — see https://ranqa.me/developers
Do widgets replace Schema.org AggregateRating?: No. Widgets embed a live score on your storefront. Search engines crawl AggregateRating on your public Ranqa company/product pages when reviews exist.
How long does a typical commerce setup take?: About 15 minutes for ready modules (token + webhook/plugin + test order). Catalog mapping and PDP widget placement may take longer depending on your theme.