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

Перед тем как создавать намерение, вы можете проверить возможность пополнения счета или доступность товара. Для этого можно использовать метод проверки возможности пополнения или проверки доступности товара.

1

Создание намерения

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

2

Выставление счета

Передавая идентификатор намерения, вы получаете ссылку на платежную форму, которую нужно передать геймеру для оплаты.

3

Автоматическое зачисление

После оплаты, мы обрабатываем оповещение от платежной системы и автоматически зачисляем средства на счет или отправляем покупку геймеру.

​
Создание намерения

Для создания намерения на пополнение счета, вам необходимо отправить POST запрос на адрес /gold или /items. Подробнее о методе создания намерения вы можете прочитать в разделе создание намерения для пополнения или намерения для покупки товара.

// Обратите внимание на поле verified
{
  "status": 200,
  "intentId": "5f7b1b4b-7b7b-4b7b-7b7b-7b7b7b7b7b7b",
  "verified": "true"
}

Значение true в поле verified в ответе на запрос означает, что намерение прошло проверку и готово к оплате. Если поле verified равно false, значит такой аккаунт не может быть пополнен или товар недоступен.

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

​
Получение ссылки на оплату

Для получения ссылки на платежную форму, вам необходимо отправить POST запрос на адрес /gold/{id}/checkout или /items/{id}/checkout. В адресе запроса вы должны передать идентификатор намерения, который вы получили после создания намерения. Подробнее о методе получения ссылки на платежную форму вы можете прочитать в разделе выставление счета на пополнение или счета на покупку товара.

{
  "code": 200,
  "paymentId": "5555555555",
  "paymentUrl": "https://securepayments.tinkoff.ru/g0ld3Nj0y3R",
  "message": "Payment initiated"
}

В ответе на запрос будет содержаться ссылка на платежную форму, которую нужно передать геймеру для оплаты.

​
Результат транзакции

Есть два способа узнать результат транзакции:

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