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

Shopify review invites & widgets

Embed your score and send review invites after paid or fulfilled orders — about 15 minutes with a webhook token. Free to verify your company page.

1. Theme widget

Paste an iframe in footer, product page, or cart. Get your slug from the dashboard.

Put the badge in the site footer. Shoppers see a live RanqaScore and search engines get a natural link back to your Ranqa page.

{% comment %} Ranqa score badge — replace SLUG {% endcomment %}
<iframe
  src="https://ranqa.me/widget/SLUG?type=badge"
  width="280"
  height="90"
  style="border:0;overflow:hidden"
  title="RanqaScore"
  loading="lazy"
></iframe>

2. Order → invite

Point a Shopify webhook at Ranqa. Commerce or Pro — token URL, no custom headers.

Typical setup: ~15 minutes.

Download Shopify package (.zip) →

Dashboard → Shopify / Woo: create a webhook token.
Shopify → Settings → Notifications → Webhooks (or Flow).
Event: Order payment / Order fulfillment. Format: JSON.
Paste the token URL from the dashboard as the delivery URL.

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

(Shopify order JSON — email + line_items used)

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

Map Shopify product_id to Ranqa product.externalId so product invites link correctly.

Open dashboard setup →

3. Full API

You can also call POST /api/v1/invites with a Bearer API key.

API documentation →

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.