API

API для решения спорных ситуаций вокруг оплаты и доступа

Xavionis принимает события по оплате, повторным попыткам, доступу и поддержке. На выходе API возвращает понятное действие по ситуации: APPROVE, REVIEW, ESCALATE или REJECT.

API не проводит платежи, не открывает доступ сам и не заменяет вашу бизнес-логику. Он добавляет сигнал, который можно использовать в вашем процессе.

Core idea

Отправляете событие - получаете действие по ситуации

Ваша система отправляет событие: оплата, retry, изменение доступа, обращение в поддержку или ручное действие. Xavionis обновляет контекст и возвращает актуальное решение.

один пользователь или кейс может иметь несколько связанных событий;

важна не только текущая операция, но и то, что было до неё;

ответ API должен быть понятен продукту, поддержке и разработке.

Пример запроса

POST /decision
X-API-Key: your_api_key
Content-Type: application/json

{
  "user_id": "user_1842",
  "case_id": "case_1842",
  "event_type": "retry_attempted",
  "event_status": "succeeded",
  "amount": 1900,
  "currency": "USD",
  "access_state": "inactive"
}

Event flow

API работает с цепочкой событий, а не с одной строкой статуса

Спорная ситуация часто становится понятной только после связи нескольких событий: что произошло с оплатой, что стало с доступом, писал ли клиент в поддержку, повторялась ли такая цепочка раньше.

Payment

Платёж прошёл, не прошёл, повторился или восстановился после retry.

Access

Доступ активен, отключён, не восстановился или конфликтует с оплатой.

Support

Клиент написал, кейс повторился или ушёл в ручной разбор.

Decision

API возвращает действие, которое можно использовать в вашем процессе.

Пример ответа

{
  "case_id": "case_1842",
  "user_id": "user_1842",
  "recommendation": "ESCALATE",
  "suggested_action": "priority_support_review",
  "review_priority": "high",
  "case_severity": "critical",
  "reason_codes": [
    "paid_user_without_access",
    "retry_success_access_not_restored",
    "repeated_support_request"
  ],
  "case_memory": {
    "case_total_events": 4,
    "access_conflicts": 1,
    "support_requests": 2
  }
}

Response

Ответ должен объяснять, что делать дальше

В ответе важен не только числовой показатель. Команде нужно понять, какое действие нужно выполнить и почему ситуация получила такой статус.

recommendation	главное действие по ситуации
suggested_action	что именно стоит сделать в процессе
review_priority	насколько срочно нужен разбор
reason_codes	почему API вернул такое решение
case_memory	что уже известно по этой цепочке событий

Decisions

Четыре действия, которые можно встроить в ваш процесс

APPROVE

Ситуацию можно вести дальше без ручного вмешательства.

REVIEW

Нужна обычная проверка или подтверждение.

ESCALATE

Нужно срочно передать ответственному или поддержке.

REJECT

Не стоит вести ситуацию как обычную.

Boundaries

Что API Xavionis не делает

Границы важны. Xavionis не должен вмешиваться туда, где решение должна принимать ваша система или ваша команда.

не создаёт и не проводит платежи;

не открывает и не закрывает доступ сам;

не заменяет Stripe, CloudPayments, ЮKassa, PayPal или другой процессор;

не принимает финальное бизнес-решение вместо клиента;

не требует полного внедрения для Free Replay Check.

Start

Не начинайте с полной интеграции

Сначала проверьте Xavionis на 20-50 реальных спорных ситуациях. Если сигнал есть, API можно подключать уже под понятный рабочий контур.

Запросить Free Replay Check Задать вопрос