Quickstart за 5 минут

Эта страница подключает безопасную сделку ARIS к любой странице товара. На выходе — кнопка «Продолжить через ARIS», эскроу, документооборот и согласование с ARIS ID покупателя.

1. Получите ключи маркетплейса

После активации маркетплейса в админ-панели вы получаете два ключа:

• mk_… — секретный ключ для server-to-server вызовов
• pk_… — публичный ключ для встраивания виджета на витрину

2. Подключите виджет на странице товара

<script src="https://arisdoc.cloud/widget/marketplace.js"></script>
<div id="aris-deal-widget"
     data-public-key="pk_xxxxxxxxxxxxxxxxxxxxxxxx"
     data-marketplace-id="metal"
     data-external-id="order-100245"
     data-buyer-email="buyer@example.com"
     data-seller-email="supplier@zavod.ru"
     data-title="Арматура А500С 12мм, 20т"
     data-amount="1480000"
     data-currency="RUB"></div>
<script>
  ArisMarketplaceWidget.init({
    container: "#aris-deal-widget",
    mode: "full",
    theme: "light",
    locale: "ru"
  });
</script>

3. Настройте webhook для статусов

Когда покупатель проходит согласование и оплачивает сделку, ARIS присылает webhook на ваш сервер:

curl -X POST https://arisdoc.cloud/api/mkt/webhook \
  -H "X-Aris-Key: mk_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-marketplace.com/aris/webhook"}'

В ответ вы получите whsec_… — секрет для проверки HMAC-подписи X-Aris-Signature на ваших входящих webhook'ах.

4. Проверьте подпись webhook'а

import crypto from "node:crypto";

app.post("/aris/webhook", (req, res) => {
  const sig = req.headers["x-aris-signature"];
  const body = JSON.stringify(req.body);
  const expected = crypto.createHmac("sha256", process.env.ARIS_WEBHOOK_SECRET).update(body).digest("hex");
  if (sig !== expected) return res.status(401).end();
  // body.event = "deal.approved" | "deal.escrow_hold" | "deal.paid" | "deal.rejected"
  console.log("ARIS:", req.body.event, req.body.external_id);
  res.status(200).end();
});

Что дальше