Skip to main content

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 в запросе на создание намерения на пополнение счета. Подробнее о методе создания намерения вы можете прочитать в разделе создание намерения.

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

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

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

// Пример уведомления
{
  "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. 

// Пример уведомления
{
	"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 — это сумма и валюта платежа.
Прямо сейчас наша система не будет отправлять уведомления повторно, если ваш сервер не ответит на уведомление. Если вам нужна надежная система проверки статуса платежей, то рекомендуем использовать метод проверки статуса намерения.