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


Формирование запроса к API при самостоятельной интеграции:
Пример использования SDK:
#!/bin/bash
PUBLIC_KEY='your_public_key'
PRIVATE_KEY='your_private_key'
API_URL='https://www.liqpay.ua/api/request'
JSON="{ 
	\"action\" : \"reports_compensation\",
    \"version\" : 3,
    \"public_key\" : \"${PUBLIC_KEY}\", 
    \"compensation_id\" : \"200000007\",
    \"resp_format\" : \"json\"
}"
# DATA is base64_encode result from JSON string
DATA=$(echo -n ${JSON} | base64)
# SIGNATURE is base64 encode result from sha1 binary hash from concatenate string ${PRIVATE_KEY}${DATA}${PRIVATE_KEY}
SIGNATURE=$(echo -n "${PRIVATE_KEY}${DATA}${PRIVATE_KEY}" | openssl dgst -binary -sha1 | base64)
# REQ is json response from liqpay
REQ=$(curl --silent -XPOST ${API_URL} --data-urlencode data="${DATA}" --data-urlencode signature="${SIGNATURE}")
echo "Result: ${REQ}"
$liqpay = new LiqPay($public_key, $private_key);
$res = $liqpay->api("request", array(
'action'    => 'reports_compensation',
'version'   => '3',
'compensation_id' => '200000007',
'resp_format'   => 'json'
));
HashMap<String, String> params = new HashMap<String, String>();
params.put("action", "reports_compensation");
params.put("version", "3");
params.put("compensation_id", "200000007");
params.put("resp_format", "json");

LiqPay liqpay = new LiqPay(PUBLIC_KEY, PRIVATE_KEY);
HashMap<String, Object> res = liqpay.api("request", params);		
System.out.println(res.get("status"));
from liqpay import LiqPay
liqpay = LiqPay(public_key, private_key)
res = liqpay.api("request", {
"action"    : "reports_compensation",
"version"   : "3",
"compensation_id" : "200000007",
"resp_format"   : "json"
})
liqpay = Liqpay::Liqpay.new(
:public_key  => 'public_key',
:private_key => 'private_key'
)
res = liqpay.api("request", {
:action    => "reports_compensation",
:version   => "3",
:compensation_id => "200000007",
:resp_format   => "json"
})
LiqPay = liqpay:init(PublicKey, PrivateKey),
Res = liqpay:api("request", [
{<<"action">>,    <<"reports_compensation">>},
{<<"version">>,   <<"3">>},
{<<"compensation_id">>, <<"200000007">>},
{<<"resp_format">>,   <<"json">>}
], LiqPay)
var LiqPay = require('liqpay');
var liqpay = new LiqPay(public_key, private_key);
liqpay.api("request", {
"action"    : "reports_compensation",
"version"   : "3",
"compensation_id" : "200000007",
"resp_format"   : "json"
}, function( json ){
console.log( json.status );
});
my $liqpay = Liqpay->new($public_key,$private_key);
my $res = $liqpay->api("request",
{
'action'    => 'reports_compensation',
'version'   => '3',
'compensation_id' => '200000007',
'resp_format'   => 'json'
}
);
Init("my_public_key", "my_private_key")
Api("request", map[string]interface{}{
    "action": "reports_compensation",
    "version": 3,
    "public_key": PublicKey,
    "compensation_id": "200000007",
    "resp_format": "json",
})
Параметры для формирования data:
Основные
Parameter Required Type Description
version Required Number Версия API. Текущее значение - 3
public_key Required String Публичный ключ - идентификатор магазина. Получить ключ можно в настройках магазина
action Required String reports_compensation
compensation_id Optional String compensation_id проводки зачисления
resp_format Optional String Возможный формат отчета json, csv, xml. Если параметр не передан, по умолчанию будет передан json.
date Optional* String Если неизвестен параметр compensation_id, то передается дата, за которую нужно получить список compensation_id
Пример получения compensation_id:
{
  "result":"success",
  "data":[{"compensation_id":91330,
  "create_date":"2016-11-15 00:02:14"
  }]
}
Пример ответа:
{
  "result": "ok",
  "data": [{
  "id": 107866,
  "create_date": "2017-01-31 07:51:37",
  "end_date": "2017-01-31 07:51:54",
  "trans_type": "purchase",
  "trans_amount": 1.0,
  "trans_fee_debit": 0.0,
  "trans_fee_credit": 0.03,
  "trans_bonus": 0.0,
  "trans_total": 0.97,
  "trans_currency": "UAH",
  "action": "pay",
  "channel": "checkout",
  "paytype": "liqpay",
  "order_id": "98R1U1OV1485849059893399",
  "liqpay_order_id": "J4L8IRG81485849105029639",
  "authcode_debit": "784593",
  "description": "Мой товар",
  "ip": "8.8.8.8",
  "customer": null,
  "bonus_type": null,
  "sender_card": "5168 **** **** **16",
  "sender_card_bank": "pb",
  "sender_card_country": 804,
  "sender_card_type": "mc",
  "sender_phone": "380950000001",
  "sender_email": null,
  "sender_first_name": "test",
  "sender_last_name": "test",
  "sender_card_product_type": "KDV"
  }]
}
Параметры ответа
Parameter Type Description
action String Тип операции. Возможные значения: pay - платеж, hold - блокировка средств на счету отправителя, paysplit - расщепление платежа, subscribe - создание регулярного платежа, paydonate - пожертвование, auth - предавторизация карты, regular - регулярный платеж
authcode_debit String Код авторизации по транзакции debit
bonus_type String Тип бонуса, возможные значения bonusplus, discount_club, personal, promo
channel String Канал оплаты, возможные значения checkout, checkoutjs, api
create_date String Дата создания платежа
customer String Уникальный идентификатор пользователя на сайте мерчанта. Максимальная длина 100 символов
description String Комментарий к платежу
end_date String Дата завершения/изменения платежа
id Number Id платежа в системе LiqPay
ip String IP адрес отправителя
liqpay_order_id String Order_id платежа в системе LiqPay
order_id String Order_id платежа
paytype String Способ оплаты. Возможные значения card - оплата картой, liqpay - через кабинет liqpay, privat24 - через кабинет приват24, masterpass - через кабинет masterpass, moment_part - рассрочка, cash - наличными, invoice - счет на e-mail, qr - сканирование qr-кода.
sender_card String Карта отправителя
sender_card_bank String Банк отправителя
sender_card_country String Страна карты отправителя. Цифровой ISO 3166-1 код
sender_card_product_type String Тип карточного продукта
sender_card_type String Тип карты отправителя MC/Visa
sender_email String Email плательщика
sender_first_name String Имя отправителя
sender_last_name String Фамилия отправителя
sender_phone String Телефон отправителя
trans_amount Number Сумма транзакции
trans_bonus Number Сумма бонуса по транзакции
trans_currency String Валюта транзакции
trans_fee_credit Number Сумма комиссии транзакции кредита
trans_fee_debit Number Сумма комиссии транзакции дебета
trans_total Number Сумма возмещения компании
trans_type String Тип транзакции. Возможные значения reverse, hold_compl, purchase, refund