API LiqPay: Callback 3.0. Ответ сервера.

1 сообщение / 0 новое
WT George
Аватар пользователя WT George
API LiqPay: Callback 3.0. Ответ сервера.

Kiss 2 если было полезно, жми кнопку + 
Информация обновлена на январь 2016.

Оглавление Документация Callback API LiqPay

Сравнение Callback параметров API LiqPay: 2.0 vs 3.0

Сравнение Callback параметров API LiqPay: 2.0 vs 3.0
Callback: API Liq&Buy
2.0
старый
описание
переменной
Callback: API Checkout
3.0
новый
тип
переменной
API 3.0
Уведомление о смене статуса платежа  server_url 
После смены статуса платеж, если был указан параметр
 server_url , на Ваше API будет отправлен  POST  запрос с новым статусом платежа.
  Уведомление о смене статуса платежа  server->server 
После смены статуса платеж, если был указан параметр
server_url , на Ваше API будет отправлен  POST  запрос
с двумя параметрами  data  и  signature  , где:
  •  data  - результат функции <?php base64_encode$json_string ?>
  •  signature  - результат функции
    <?php base64_encodesha1$private_key $data $private_key) ) ?>
public_key =
Публичный ключ магазина
public_key String
amount =
Сумма платежа
amount Number
currency
Возможные значения: USD, EUR, RUB, UAH, GEL
=
Валюта платежа
currency String
description =
Комментарий к платежу (описание платежа)
description String
order_id
Максимальная длина 255 символов
=
Уникальный ID платежа
order_id
Обратить внимание ниже на схожий параметр payment_id
String
type
default: buy Возможные значения:
  • buy - покупка
  • donate - пожертвование
  • subscribe - подписка
Если тип платежаdonateплательщик сможет изменить сумму платежа
=
Тип платежа
type String
sender_phone =
Телефон плательщика в международном формате
sender_phone String
status
Возможные значения:
  • success: успешный платеж
  • failure: не успешный платеж
  • wait_secure: платеж на проверке
  • sandbox: тестовый платеж
=
Статус платежа
status
Возможные значения:
  • Конечные статусы платежа
    • success: успешный платеж
    • failure: неуспешный платеж
    • error: Неуспешный платеж. Некорректно заполнены данные
    • subscribed: Подписка успешно оформлена
    • unsubscribed: Подписка успешно деактивирована
    • reversed: Платеж возвращен
    • sandbox: тестовый платеж
  • Cтатусы требующие подтверждения платежа
  • Cтатусы ожидающие обработку платежа
String
signature
Результат функций <?php sha1 ?> и <?php base64 ?>
  • Проверка Callback сигнатуры
    • <?php $sign base64_encodesha1
          
      private_key 
          
      amount 
          
      currency 
          
      public_key 
          
      order_id 
          
      type 
          
      description 
          
      status .
          
      transaction_id .
          
      sender_phone 
      )); ?>

Подпись запроса
signature
Результат функций <?php sha1 ?> и <?php base64 ?>
  • Проверка Callback сигнатуры по алгоритму
    <?php base64_encode(sha1($private_key.$data.$private_key,1)) ?>
    • <?php $sign base64_encodesha1
          
      $private_key .  
          
      $data 
          
      $private_key 
      )); ?>
 

Дополнительные параметры переменные Callback API LiqPay 3.0 (Checkout)

Мы привели наиболее важные на наш взгляд переменные. Полный список смотрите в документации к Callback API LiqPay 3.0

Дополнительные параметры переменные Callback API LiqPay 3.0 (Checkout)
параметр переменная описание тип
signature Результат функций <?php sha1 ?> и <?php base64 ?>
  • Проверка Callback сигнатуры по алгоритму
    <?php base64_encode(sha1($private_key.$data.$private_key,1)) ?>
    • <?php $sign base64_encodesha1
          
      $private_key .  
          
      $data 
          
      $private_key 
      )); ?>
 
payment_id Id платежа в системе LiqPay Number
err_code Код ошибки String
err_description Описание ошибки String
version Версия API. Текущее значение - 3 Number
err_erc Код ошибки String
liqpay_order_id Order_id платежа в системе Liqpay String
sender_card_mask2 Карта отправителя String
sender_card_bank Банк отправителя String
sender_card_country Страна отправителя. Цифровой ISO 3166-1 код String
ip IP адрес отправителя String
info Дополнительная информация о платеже String
customer Уникальный идентификатор пользователя на сайте мерчанта. Максимальная длина 100 символов. String
sender_commission Комиссия с отправителя в валюте платежа Number
receiver_commission Комиссия с получателя в валюте платежа Number
agent_commission Комиссия агента в валюте платежа Number
action Тип операции.
Возможные значения: pay - платеж, hold - блокировка средств на счету отправителя, paysplit - разбивка суммы, subscribe - регулярный платеж, pay_donate - пожертвование
String
mpi_eci Electronic Commerce Indicator Параметр, содержащий информацию о проведении транзакции.
Возможные значения:
  • 5 - транзакция с полной 3D-Secure аутентификацией, пароль клиента был проверен эмитентом, 
  • 6 - попытка проведения 3D-Secure транзакция, эмитент проверил валидность карты, но клиент не аутентифицирован по паролю, так как не вводил его по одной из причин: 
    • карта не активирована в сервисе 3D-Secure 
    • эмитент не поддерживает полную 3D-Secure аутентификацию 
  • 7 - 3D-Secure аутентификация невозможна по одной из причин:  сервер эмитента на данный момент недоступен 
    • карта бизнес, корпоративная или предоплаченная
String