ARIS Docs/API/Эскроу · ARIS Pay

Эскроу · ARIS Pay

ARIS Pay удерживает деньги покупателя до подтверждения поставки. Раскрытие — отдельный шаг (Confirm/capture), отмена — возврат на карту покупателя (Cancel).

Захолдировать оплату

После согласования сделки покупателем — инициируйте эскроу:

curl -X POST https://arisdoc.cloud/api/mkt/deals/{deal_id}/escrow \
  -H "X-Aris-Key: mk_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{}'

В live-режиме возвращается ссылка на платёжную страницу эквайера:

{
  "ok": true,
  "payment_id": "6f17…",
  "amount": 1480000,
  "provider": "tbank",
  "status": "pending",
  "payment_url": "https://securepayments.tinkoff.ru/…"
}

В sandbox-режиме статус сразу hold — это удобно для прогона интеграции на тестовых данных без эквайера.

Жизненный цикл платежа

| Платёж | Что значит | |----------------|------------------------------------------------| | pending | Покупатель ещё не оплатил платёжную ссылку | | hold | Деньги захолдированы у эквайера | | released | Сделка раскрыта (деньги отправлены поставщику) | | refunded | Сделка отменена (деньги возвращены покупателю) | | disputed | Открыт спор, ожидается решение арбитра |

Раскрытие, отмена и споры

Эти операции выполняются из ARIS-кабинета (Escrow раздел) или администратором маркетплейса. При каждом изменении статуса вы получаете webhook deal.paid / deal.refunded / deal.disputed.

Эскроу можно инициировать только после статуса approved. Попытка вызвать /escrow для сделки в approval вернёт 400.