callbacks.payment
Обратная связь, вызываемая API для уведомления удаленного сервера приложений о завершении транзакции. Используется для игровых платежей и для игровых подписок
| Название | Обязательный | Тип | Описание |
|---|---|---|---|
| uid | Да | Идентификатор пользователя | |
| transaction_id | Да | Уникальный идентификатор транзакции. Для некоторых действий (начало триального периода игровой подписки, отказ от подписки) параметр может отсутствовать | |
| transaction_time | Да | Время транзакции в формате yyyy-mm-dd HH:MM:SS | |
| product_code | Нет | Код продукта | |
| product_option | Нет | Код выбранного варианта продукта | |
| amount | Да | Общая сумма в виртуальной валюте портала | |
| currency | Нет | Валюта платежа (за исключением платежей в «ok») | |
| payment_system | Нет | Система оплаты в случае прямых платежей в валюте RUR | |
| extra_attributes | Нет | JSON-кодированные пары ключей/значений, содержащие дополнительные параметры транзакции, которые передает приложение в методе FAPI.UI.showPayment. | |
| trial_days | Нет | Пробный период в днях купленной игровой подписки | |
| card_promo | Нет |
Авторизация
Сессия запрещенаНеобходимые права
- VALUABLE_ACCESS
См. также пример проведения платежа в HTML-приложении с серверной частью на PHP.
- Обратная связь вызывается 3 раза до получения успешного ответа HTTP. Каждая попытка имеет задержку 5 секунд. Если сервер не отвечает, транзакция будет отменена, а виртуальные деньги возвращены пользователю.
- Работает только через HTTP GET;
- Поддерживает ответы двух форматов - XML и JSON (см. примеры таких ответов ниже);
- Тип содержимого должен быть “application/xml” или “application/json”;
- В случае ошибки HTTP-заголовок “Invocation-error” должен содержать код ошибки;
- Разработчик обязан проверять соответствие товара и его цены, передаваемых в параметрах product_code и amount. В противном случае злоумышленник сможет совершать любые покупки в игре за минимальную стоимость;
- Разработчик должен проверять значение подписи sig из запроса.
Список адресов, с которых будет вызываться метод:
- 217.20.145.192/28
- 217.20.151.160/28
- 217.20.153.48/28
Коды ошибок
| Имя | Код | Описание |
|---|---|---|
| UNKNOWN | 1 | Неизвестная ошибка |
| SERVICE | 2 | Сервис временно недоступен |
| CALLBACK_INVALID_PAYMENT | 1001 | Платеж неверный и не может быть обработан |
| SYSTEM | 9999 | Критический системный сбой, который невозможно устранить |
| PARAM_SIGNATURE | 104 | Неверная подпись |
Варианты ответа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<callbacks_payment_response xmlns="http://api.forticom.com/1.0/">
true
</callbacks_payment_response><?xml version="1.0" encoding="UTF-8"?>
<ns2:error_response xmlns:ns2='http://api.forticom.com/1.0/'>
<error_code>1001</error_code>
<error_msg>CALLBACK_INVALID_PAYMENT : Payment is invalid and can not be processed</error_msg>
</ns2:error_response>Варианты ответа в формате JSON
true{
"error_code": 1001,
"error_msg": "CALLBACK_INVALID_PAYMENT : Payment is invalid and can not be processed",
"error_data": null
}