Connect KartmaX to Idukki for reviews and UGC

Status

Connect

• In the Idukki dashboard open Settings, then the KartmaX tab under Integrations, and create a key in the Store connection card. Early-access accounts have the tab switched on for them.
• The key starts with idk_pc_ and is shown once, when you create it. Idukki keeps only a hash of it, so a lost key cannot be shown again: revoke it and make a new one. One key belongs to one store and one platform; a Magento key is refused by a PrestaShop store. Revoking a key in the dashboard stops the module at once.
• Note your Business ID (data-bguid) and the gallery ID (data-guid) for the Product reviews hub widget.

Embed on a KartmaX PDP

<div data-ugc="idukki" data-bguid="YOUR_BGUID" data-guid="YOUR_HUB_GUID" filter-pid="{{product.id}}"></div>
<script src="https://idukki-cdn.com/version/script_0" async></script>

Place Product Rating Stars via GET /webfeed/{bguid}/rating?productId=… under the title if you want aggregate stars + first-party JSON-LD.

Post-purchase review invites

Idukki does not send KartmaX shoppers email. After an order is placed (and ingested), call review-invites and put uploadUrl in your ESP / WhatsApp template.

curl -X POST https://api.idukki.io/webhooks/partner/review-invites \
  -H "Authorization: Bearer idk_pc_…" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "kartmax",
    "orderId": "KX-1001",
    "email": "buyer@example.com",
    "kind": "both",
    "order": {
      "id": "KX-1001",
      "createdAt": "2026-10-31T12:00:00Z",
      "currency": "INR",
      "total": "1999.00",
      "lineItems": [{ "productId": "SKU-1", "quantity": 1, "price": 1999 }]
    }
  }'

Response includes uploadUrl (30-day signed token), campaignUrl, and echoes recipientEmail for your template only — email is not stored on this path.

Orders and attribution

Idukki matches each order to widget activity through the visitor id first, then the customer id and the cart id. An order counts as proven only when the same visitor added a product they bought to the cart from the widget beforehand. Orders that only followed a widget view or click land in the influence tiers, and the rest are store orders. The dashboard keeps proven, influenced and store orders in separate columns and never adds them together.