Публичный
Статус платежа
Получение статуса по платежу

Формирование запроса к API при самостоятельной интеграции:
Пример использования SDK:
#!/bin/bash
PUBLIC_KEY='your_public_key'
PRIVATE_KEY='your_private_key'
API_URL='https://www.liqpay.ua/api/request'
JSON="{ 
	\"action\" : \"status\",
	\"version\" : 3,
	\"public_key\" : \"${PUBLIC_KEY}\", 
	\"order_id\" : \"order_id_1\"
}"
# 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'        => 'status',
'version'       => '3',
'order_id'      => 'order_id_1'
));
HashMap<String, String> params = new HashMap<String, String>();
params.put("action", "status");
params.put("version", "3");
params.put("order_id", "order_id_1");

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"        : "status",
"version"       : "3",
"order_id"      : "order_id_1"
})
liqpay = Liqpay::Liqpay.new(
:public_key  => 'public_key',
:private_key => 'private_key'
)
res = liqpay.api("request", {
:action        => "status",
:version       => "3",
:order_id      => "order_id_1"
})
LiqPay = liqpay:init(PublicKey, PrivateKey),
Res = liqpay:api("request", [
{<<"action">>, <<"status">>},
{<<"version">>, <<"3">>},
{<<"order_id">>, <<"order_id_1">>}
], LiqPay)
var LiqPay = require('liqpay');
var liqpay = new LiqPay(public_key, private_key);
liqpay.api("request", {
"action"   : "status",
"version"  : "3",
"order_id" : "order_id_1"
}, function( json ){
console.log( json.status );
});
my $liqpay = Liqpay->new($public_key,$private_key);
my $res = $liqpay->api("request",
{
'action'        => 'status',
'version'       => '3',
'order_id'      => 'order_id_1'
}
);
Init("my_public_key", "my_private_key")
Api("request", map[string]interface{}{
    "action": "status",
    "version": 3,
    "public_key": PublicKey,
    "order_id": "order_id_1",
})
Параметры для формирования data:
Основные
Parameter Required Type Description
version Required Number Версия API. Текущее значение - 3
public_key Required String Публичный ключ - идентификатор магазина. Получить ключ можно в настройках магазина
action Required String status
order_id Required String Уникальный ID покупки в Вашем магазине. Максимальная длина 255 символов.
Пример ответа:
{
  "action": "pay",
  "payment_id": 165629,
  "status": "success",
  "version": 3,
  "type": "buy",
  "paytype": "card",
  "public_key": "i000000000",
  "acq_id": 414963,
  "order_id": "98R1U1OV1485849059893399",
  "liqpay_order_id": "NYMK3AE61501685438251925",
  "description": "test",
  "sender_phone": "380950000001",
  "sender_card_mask2": "473118*97",
  "sender_card_bank": "pb",
  "sender_card_type": "visa",
  "sender_card_country": 804,
  "ip": "8.8.8.8",
  "card_token": "2DFBFE626B7341611450DE81E971E948D6F260",
  "info": "My information",
  "amount": 0.02,
  "currency": "UAH",
  "sender_commission": 0.0,
  "receiver_commission": 0.0,
  "agent_commission": 0.0,
  "amount_debit": 0.02,
  "amount_credit": 0.02,
  "commission_debit": 0.0,
  "commission_credit": 0.0,
  "currency_debit": "UAH",
  "currency_credit": "UAH",
  "sender_bonus": 0.0,
  "amount_bonus": 0.0,
  "bonus_type": "bonusplus",
  "bonus_procent": 7.0,
  "authcode_debit": "108527",
  "authcode_credit": "703006",
  "rrn_debit": "000664267598",
  "rrn_credit": "000664267607",
  "mpi_eci": "7",
  "is_3ds": false,
  "create_date": 1501757716373,
  "end_date": 1501757729972,
  "moment_part": true,
  "transaction_id": 165629
}
Параметры ответа
Parameter Type Description
acq_id Number ID эквайера
action String Тип операции. Возможные значения: pay - платеж, hold - блокировка средств на счету отправителя, paysplit - расщепление платежа, subscribe - создание регулярного платежа, paydonate - пожертвование, auth - предавторизация карты, regular - регулярный платеж
agent_commission Number Комиссия агента в валюте платежа
amount Number Сумма платежа
amount_bonus Number Бонус отправителя в валюте платежа debit
amount_credit Number Сумма транзакции credit в валюте currency_credit
amount_debit Number Сумма транзакции debit в валюте currency_debit
authcode_credit String Код авторизации по транзакции credit
authcode_debit String Код авторизации по транзакции debit
bonus_procent Number Размер скидки в процентах
bonus_type String Тип бонуса, возможные значения bonusplus, discount_club, personal, promo
card_token String Token карты оправителя
commission_credit Number Комиссия с получателя в валюте currency_credit
commission_debit Number Комиссия с отправителя в валюте currency_debit
create_date String Дата создания платежа
currency String Валюта платежа
currency_credit String Валюта транзакции credit
currency_debit String Валюта транзакции debit
description String Комментарий к платежу
end_date String Дата завершения/изменения платежа
info String Дополнительная информация о платеже
ip String IP адрес отправителя
is_3ds Boolean Возможные значения:
true - транзакция прошла с 3DS проверкой,
false - транзакция прошла без 3DS проверки
liqpay_order_id String Order_id платежа в системе LiqPay
moment_part String Признак оплаты частями
mpi_eci Number Возможные значения: 5 - транзакция прошла с 3DS (эмитент и эквайер поддерживают технологию 3D-Secure), 6 - эмитент карты плательщика не поддерживает технологию 3D-Secure, 7 - операция прошла без 3D-Secure
order_id String Order_id платежа
payment_id Number Id платежа в системе LiqPay
paytype String Способ оплаты. Возможные значения card - оплата картой, liqpay - через кабинет liqpay, privat24 - через кабинет приват24, masterpass - через кабинет masterpass, moment_part - рассрочка, cash - наличными, invoice - счет на e-mail, qr - сканирование qr-кода.
public_key String Публичный ключ магазина
receiver_commission Number Комиссия с получателя в валюте платежа
rrn_credit String Уникальный номер транзакции в системе авторизации и расчетов обслуживающего банка Retrieval Reference number
rrn_debit String Уникальный номер транзакции в системе авторизации и расчетов обслуживающего банка Retrieval Reference number
sender_bonus Number Бонус отправителя в валюте платежа
sender_card_bank String Банк отправителя
sender_card_country String Страна карты отправителя. Цифровой ISO 3166-1 код
sender_card_mask2 String Карта отправителя
sender_card_type String Тип карты отправителя MC/Visa
sender_commission Number Комиссия с отправителя в валюте платежа
sender_phone String Телефон отправителя
status String Статус платежа.
Возможные значения:
Конечные статусы платежа
error Неуспешный платеж. Некорректно заполнены данные
failure Неуспешный платеж
reversed Платеж возвращен
subscribed Подписка успешно оформлена
success Успешный платеж
unsubscribed Подписка успешно деактивирована
Cтатусы требующие подтверждения платежа
3ds_verify Требуется 3DS верификация.
Для завершения платежа, требуется выполнить 3ds_verify
captcha_verify Ожидается подтверждение captcha
cvv_verify Требуется ввод CVV карты отправителя.
Для завершения платежа, требуется выполнить cvv_verify
ivr_verify Ожидается подтверждение звонком ivr
otp_verify Требуется OTP подтверждение клиента. OTP пароль отправлен на номер телефона Клиента.
Для завершения платежа, требуется выполнить otp_verify
password_verify Ожидается подтверждение пароля приложения Приват24
phone_verify Ожидается ввод телефона клиентом.
Для завершения платежа, требуется выполнить phone_verify
pin_verify Ожидается подтверждение pin-code
receiver_verify Требуется ввод данных получателя.
Для завершения платежа, требуется выполнить receiver_verify
sender_verify Требуется ввод данных отправителя.
Для завершения платежа, требуется выполнить sender_verify
senderapp_verify Ожидается подтверждение в приложении Privat24
wait_qr Ожидается сканирование QR-кода клиентом
wait_sender Ожидается подтверждение оплаты клиентом в приложении Privat24/SENDER
p24_verify Ожидается завершение платежа в Приват24
mp_verify Ожидается завершение платежа в кошельке MasterPass
Другие статусы платежа
cash_wait Ожидается оплата наличными в ТСО
hold_wait Сумма успешно заблокирована на счету отправителя
invoice_wait Инвойс создан успешно, ожидается оплата
prepared Платеж создан, ожидается его завершение отправителем
processing Платеж обрабатывается
wait_accept Деньги с клиента списаны, но магазин еще не прошел проверку. Если магазин не пройдет активацию в течение 90 дней, платежи будут автоматически отменены
wait_card Не установлен способ возмещения у получателя
wait_compensation Платеж успешный, будет зачислен в ежесуточной проводке
wait_lc Аккредитив. Деньги с клиента списаны, ожидается подтверждение доставки товара
wait_reserve Средства по платежу зарезервированы для проведения возврата по ранее поданной заявке
wait_secure Платеж на проверке
try_again Оплата неуспешна. Клиент может повторить попытку еще раз
transaction_id Number Id транзакции в системе LiqPay
type String Тип платежа
version Number Версия API. Текущее значение - 3