> ## Documentation Index
> Fetch the complete documentation index at: https://steamgold.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Оповещения

> Получение оповещений об оплате и закрытии намерений

Для получения оповещений об оплате и закрытии намерений, вы можете использовать наш webhook. Webhook — это метод, который позволяет вашему серверу получать уведомления о событиях в нашей системе.

## Создание webhook

Для получения оповещения вам нужно передать `callbackUrl` в запросе на создание намерения на пополнение счета. Подробнее о методе создания намерения вы можете прочитать в разделе [создание намерения](/api-docs/gold/create).

## Типы уведомлений

### Успешная оплата

После получения подтверждения оплаты, на ваш сервер будет отправлено уведомление о результате транзакции. В уведомлении будет содержаться информация о статусе транзакции и дополнительные данные о транзакции.

```json theme={null}

// Пример уведомления
{
  "intentId": "5f4b3b4b-4b3b-4b3b-4b3b-4b3b4b3b4b3b",
  "intentAmount": 1000,
  "intentCurrency": "RUB",
  "verification": "verified",
  "payment": "paid",
  "paymentId": "8c3b21b5-3b21-3b21-3b21-9c3b21b5c3b2",
  "paymentAmount": 1250,
  "paymentCurrency": "RUB",
  "createdAt": "2024-16-10T12:00:00Z"
}

```

### Просроченное намерение

При истечении срока жизни намерения, будет отправлено уведомление о смене статуса на `expired`.

```json theme={null}

// Пример уведомления
{
	"intentId": "5f4b3b4b-4b3b-4b3b-4b3b-4b3b4b3b4b3b",
	"intentAmount": 1000,
	"intentCurrency": "RUB",
	"verification": "verified",
	"payment": "expired",
	"paymentId": "8c3b21b5-3b21-3b21-3b21-9c3b21b5c3b2",
	"paymentAmount": 1250,
	"paymentCurrency": "RUB",
	"createdAt": "2024-16-10T12:00:00Z"
}

```

## Обратите внимание

В оповещении содержится информация о намерении и платеже. Намерение — это запрос на пополнение счета, а платеж — это фактическая транзакция. Таким образом `intentAmount` и `intentCurrency` — это сумма и валюта запроса на пополнение, а `paymentAmount` и `paymentCurrency` — это сумма и валюта платежа.

<Warning>
  Прямо сейчас наша система не будет отправлять уведомления повторно, если ваш сервер не ответит на уведомление. Если вам нужна надежная система проверки статуса платежей, то рекомендуем использовать метод [проверки статуса намерения](/api-docs/gold/status).
</Warning>