Comment on page
Обработчик платежа
По мере выполнения платежа мы уведомляем платформу магазина о статусе оплаты, последовательно отправляя GET запросы на URL обработчика.

Важно: домен в обработчике платежей должен полностью совпадать с тем, который вы добавляете к нам в систему в качестве проекта
CHECK: проверка возможности оказания услуги абоненту, запрос отправляется до прохождения оплаты. Вы должны подтвердить готовность системы (проверить корректность суммы платежа, существование счета в БД и т. д.)
PAY: уведомление об успешном списании, вы должны оказать услугу абоненту. При любой ошибке на данном этапе (например, не доступна БД) платеж получает статус «Не завершен». После устранения проблем вы можете повторно провести платеж в интерфейсе статистики. Деньги зачисляются на баланс партнера независимо от ответа обработчика
PREAUTH: уведомление в платежах с преавторизацией, когда средства успешно заблокированы. Важно! Не следует оказывать услугу или выдавать товар плательщику при получении такого уведомления. Списание средств и оказание услуги следует совершать при выполнении confirmPayment
ERROR: ошибка платежа на любом из этапов. Если ошибка вызвана пустым/ошибочным ответом сервера партнера, то запрос отправлен не будет. Следует учесть, что данный статус не конечный и возможны ситуации, когда после запроса ERROR может последовать запрос PAY.
https://адрес_вашего_обработчика?
method=check
params[account]=userId
params[date]=2012-10-01 12:32:00
params[operator]=beeline
params[paymentType]=mc
params[projectId]=1
params[phone]=9XXXXXXXXX
params[payerSum]=10.00
params[payerCurrency]=RUB
params[signature]=9bdf52a4830779a1383ac24f1b3ed054
params[orderSum]=10.00
params[orderCurrency]=RUB
params[unitpayId]=1234567
params[test]=0
| Значение | Описание |
method | string | check — запрос на проверку состояния абонента
pay — уведомление о списании
error — уведомление об ошибке |
unitpayId | число | Внутренний номер платежа в UnitPay |
projectId | число | ID проекта в UnitPay |
account | string | Идентификатор абонента в системе партнера |
payerSum | число | Сумма списания с лицевого счета абонента |
sum | число | Сумма списания с лицевого счета абонента (дополнительное значение) |
ip | string | IP-адрес плательщика (с которого инициировано создание платежа) |
isPreauth | число | Признак платежа с преавторизацией, если запрос делается с использованием механизма преавторизации, то значение будет равно 1. Для платежей вне механизма преавторизации значение всегда 0 |
payerCurrency | string | Валюта списания с лицевого счета абонента по стандарту ISO 4217 (RUB, UAH, BYN, EUR, USD) |
profit | число | Ваш доход с данного платежа, в рублях |
phone | число | Телефон плательщика (передается только для мобильных платежей) |
paymentType | string | |
orderSum | число | Сумма заказа. Обязательно сверяйте поступившее значение с оригинальной суммой заказа |
orderCurrency | string | Валюта заказа по стандарту ISO 4217 (RUB, UAH, BYN, EUR, USD). Обязательно сверяйте поступившее значение с оригинальной валютой заказа |
operator | string | |
date | string | Дата платежа в формате YYYY-mm-dd HH:ii:ss (например 2012-10-01 12:32:00) |
errorMessage | string | Детализация ошибки (только для метода error) |
test | число | Признак тестового режима, если запрос делается с использованием механизма "тестового запроса", то значение будет равно 1. Для реальных платежей значение всегда 0 |
3ds | число | Признак наличия 3-DS для операций по карте, флаг присутствует при PAY уведомлениях |
subscriptionId | число | Идентификатор подписки, возвращается после успешной оплаты установочного платежа по подписке. Присутствует при PREAUTH и PAY уведо млениях |
signature | string |