Если Вы хотите получать статус транзакции, использовать рекуррентные или двухстадийные платежи, то Вам может быть интересна возможность получать нотификации об оплате. Для этого Вам необходимо при создании сервиса указать . Если URL указан, а чекбокс не включен, то скрипт вызываться не будет!

В случае успешного завершения платежа информация о нем будет передана Вам POST­-запросом на данный URL, а также GET-­запросом на URL страницы успешной покупки. Набор параметров для обеих рассылок идентичен. Таким образом вы можете уведомлять пользователя о деталях оплаченного заказа после редиректа на страницу успеха, основываясь на данных, полученных из нотификации: номер заказа, стоимость, дата и т.д. Подробности ниже в таблице параметров (см. оглавление).

Если при создании сервиса было заполнено поле email, то на указанную электронную почту также будет выслана информация о платеже.

Запросы от нашего сервера в случае первой неудачной попытки передаются со следующей периодичностью: 180, 180, 180 с.



Таблица параметров, передаваемых на

ПараметрВерсияОписание
tid1.0, 1.1, 2.0ID транзакции
name1.0, 1.1, 2.0Название товара или услуги. Отображается на странице оплаты.
comment1.0, 1.1, 2.0Комментарий платежа переданный в процессе инициализации платежа.
partner_id1.0, 1.1, 2.0ID партнера, то есть ваш ID
service_id1.0, 1.1, 2.0ID сервиса
order_id1.0, 1.1, 2.0ID заказа
type1.0, 1.1, 2.0Тип платежа
currency1.0, 1.1, 2.0Валюта операции, поддерживается только RUB, не участвует в формировании подписи при version = (1.0|1.1)
cost1.0, 1.1, 2.0Общая сумма заказа, переданная при инициализации платежной операции
income_total1.0, 1.1, 2.0

Общая сумма в рублях, заплаченная покупателем, может отличаться от income и system_income только в случае оплаты частями или при переносе

комиссии на плательщика

income1.0, 1.1, 2.0Сумма в рублях, полученная от платежного инструмента по данной платежной транзакции
partner_income1.0, 1.1, 2.0Сумма в рублях, дохода магазина по данной платежной транзакции
system_income1.0, 1.1, 2.0Сумма в рублях, заплаченная покупателем по данной платежной транзакции
command1.0, 1.1, 2.0Текущее действие:
  • command=process – вызывается при любой (в том числе частичной) оплате сервиса
  • command=cancel – получен отказ от платежного канала, расшифровка причины в поле resultStr
  • command=success – вызывается при полной оплате сервиса
  • command=recurrent_cancel – вызывается в случае, если держатель карты отменил рекуррентные платежи.
  • command=recurrent_expire – вызывается когда истёк срок  рекуррента.
  • command=refund – вызывается в результате выполнения операции отмены платежа. В поле result=ok или fail. А в resultStr – причина отказа.
  • command=authorize_payment – вызывается при использовании двойной авторизации при платеже
  • command=funds_blocked – вызывается при использовании двух этапной оплаты (BLOCK + CHARGE). Описание в разделе “Двухэтапные платежи (предавторизация)”.

ВАЖНО: в случае полной оплаты сервиса придут и success и process.

result1.0, 1.1, 2.0Только для command=refund, значения ‘ok’ или ‘fail’
resultStr1.0, 1.1, 2.0Текст уведомления.
version1.0, 1.1, 2.0Версия протокола уведомления. (На данный момент: 1.0, 1.1, 2.0).
Версия по умолчанию — 1.0. Переключение на другие версии производится на стороне Провайдера по запросу от клиента
phone_number1.0, 1.1, 2.0Опционально, номер телефона
email1.0, 1.1, 2.0Опционально, email
date_created1.0, 1.1, 2.0дата и время создания транзакции, формат 'YYYY-MM-DD HH24.MI.SS' (MSK)
recurrent_order_id1.0, 1.1, 2.0ID заказа (order_id), который был передан при первом вызове рекуррентного платежа (только для рекуррентных операций)
card1.0, 1.1, 2.0v 1.0 Маскированный номер карты, в случае если проведенный платеж является рекуррентным (только для рекуррентных операций)
v 1.1 и 2.0 заполнено всегда когда есть поле card
cardholder2.0Имя держателя карты если присутствует в транзакции
card_binding_id1.0, 1.1, 2.0уникальный токен для сохраненных данных карты. Устарело. Подробнее.
test1.0, 1.1, 2.0Значение 1 (только для тестовых платежей), См. описание
paid_date2.0дата и время оплаты транзакции (подтверждения оплаты платежным каналом), формат 'YYYY-MM-DD HH24.MI.SS' (MSK)
check2.0Алгоритм формирования описан в приложении №1.
check1.0, 1.1MD5 хеш от параметров: tid + name + comment + partner_id + service_id + order_id + type + cost + income_total + income + partner_income + system_income + command + phone_number + email + result + resultStr + date_created + version + card +  recurrent_order_id + test + secret_key
Где secret_key – секретный ключ сервиса. Пример формирования продемонстрирован ниже.
check(если command=refund)1.0, 1.1

MD5 хеш от параметров:'tid'+'name'+'comment'+'partner_id'+'service_id'+'order_id'+'type'+'cost'+'command'+'result'+'resultStr'+'phone_number'+'email'+'date_created'+'version'+'secret_key'

refund_ext_id1.0, 1.1, 2.0дополнительный id возврата при осуществлении нескольких возвратов в рамках транзакции. Подробнее
  • Следует отметить, что в случае полной оплаты транзакции будут сформированы два вызова – success и process. Ориентироваться на command=process не обязательно. В настоящий момент она не выполняет своих прямых функций и является устаревшей.
  • resultStr – текст уведомления. Для значений параметра command process и success он стандартный. Для command=cancel выводится то, что ответит платёжный шлюз.

Формирование подписи check для первой версии API

Версия меняется по запросу в отдел технической интеграции

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

Пример на PHP


1
$param['check']==md5($param['tid'].$param['name'].$param['comment'].$param['partner_id'].$param['service_id'].$param['order_id'].$param['type'].$param['cost'].$param['income_total'].$param['income'].$param['partner_income'].$param['system_income'].$param['command'].$param['phone_number'].$param['email'].$param['result'].$param['resultStr'].$param['date_created'].$param['version'].$secretKey);
<?php

$param = array
(
    'comment' => '',
    'phone_number' => '74952760800',
    'order_id' => '67',
    'currency' => 'RUB',
    'cost' => '511.0',
    'date_created' => '2021-01-28 21:35:49',
    'partner_id' => '250305',
    'resultStr' => 'транзакция оплачена полностью',
    'name' => 'Покупка в магазине',
    'system_income' => '511.0',
    'income_total' => '511.0',
    'partner_income' => '434.35',
    'version' => '1.0',
    'command' => 'success',
    'income' => '511.0',
    'tid' => '474541305',
    'service_id' => '85494',
    'type' => 'spg_test',
    'email' => 'test@mail.ru',
    'result' => ''
);

$secretKey = 'c9264d756f170802c4eaf9405077b946';

echo rawurlencode(md5($param['tid'].$param['name'].$param['comment'].$param['partner_id'].$param['service_id'].$param['order_id'].$param['type'].$param['cost'].$param['income_total'].$param['income'].$param['partner_income'].$param['system_income'].$param['command'].$param['phone_number'].$param['email'].$param['result'].$param['resultStr'].$param['date_created'].$param['version'].$secretKey));

Пример на Python

import hashlib
from urllib.parse import parse_qs
import pprint

secretkey = '262eb24f12d0c3fdd990eae096016055'

params_list = [
    'tid',
    'name',
    'comment',
    'partner_id',
    'service_id',
    'order_id',
    'type',
    'cost',
    'income_total',
    'income',
    'partner_income',
    'system_income',
    'command',
    'phone_number',
    'email',
    'result',
    'resultStr',
    'date_created',
    'version',
    'secretKey'
]

# Тело webhook-нотификации, полученное на URL обработчика:
qs = 'comment=&phone_number=79165483580&order_id=00000015¤cy=RUB&cost=75.0&date_created=2022-03-29+22%3A38%3A08&partner_id=250305&check=66b522b5749bfe713ac089a55a013725&resultStr=%D1%82%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D0%B8%D1%8F+%D0%BE%D0%BF%D0%BB%D0%B0%D1%87%D0%B5%D0%BD%D0%B0+%D1%87%D0%B0%D1%81%D1%82%D0%B8%D1%87%D0%BD%D0%BE&name=Acquiring+lifepay+00000015&system_income=75.0&income_total=75.0&partner_income=63.75&version=1.0&command=process&income=75.0&tid=491789584&service_id=87875&type=ipsp_test_cards_01&email=awa77%40mail.ru'
params = parse_qs(qs)
pp = pprint.PrettyPrinter()
pp.pprint(params)
values = []

for i in params_list:
    values.append(params.get(i, [''])[0])

md5_str = ''.join(values)
md5_str += secretkey
print(md5_str)
md5 = hashlib.md5(md5_str.encode('UTF-8')).hexdigest()
print('Рассчитанный MD5', md5)
print('MD5 полученный в нотификации',params['check'][0])

Примечания

Для рекуррентных платежей добавляются два поля card и recurrent_order_id и строка для подписи формируется следующим образом:

tid + name + comment + partner_id + service_id + order_id + type + cost + income_total + income + partner_income + system_income + command + phone_number + email + resultStr + date_created + version +card +  recurrent_order_id + secret_key