Документация

Создание магазина

Укажите только URL проекта. Весь процесс обычно занимает не более 5 минут.

Еще необходимо чтобы проект соответствовал требованиям системы.

Настройки магазина

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

Описание параметров

Секретное слово #1 Используется для формирования подписи в форме оплаты.
Секретное слово #2 Используется для формирования подписи в скрипте оповещения для проверки платежа.
URL оповещения Страница Вашего сайта, на который будут отправлены данные с информацией о платеже.
Метод отправки: GET / POST
Успешный URL Страница Вашего сайта, на которую будет перенаправлен пользователь после успешной оплаты.
Передает номер заказа order и номер платежа inv методом GET
Неудачный URL Страница Вашего сайта, на которую будет перенаправлен пользователь в случае неудачной оплаты.
Передает номер заказа order и номер платежа inv методом GET
Интеграция Режим интеграции сделан для упрощения переноса сайта от другого сервиса приема платежей. Подробнее
По-умолчанию: Нет.

Настройка формы оплаты (форм. ссылки)

Создаем форму оплаты в виде ссылки на страницу оплаты.

Данные передается методом GET / POST на адрес https://www.lite-kassa.ru/pay

При использовании интеграции, параметры передаются по правилам вашей старой платежной системы.

Описание параметров

Обязательные параметры
shop ID Вашего магазина
amount Сумма платежа
order Номер заказа (также это может быть название товара или логин пользователя, для зачисления средств)
sign Подпись (методика формирования подписи в платежной форме)
Необязательные параметры
method Предлагаемый метод/способ платежа (список валют). Плательщик сможет изменить его в процессе оплаты.
desc Описание платежа
email Email плательщика
phone Номер телефона плательщика (только цифры с кодом города, например: 74999905568)
ap_key Так же Вы можете передавать свои параметры, которые наш сервер вернет на Ваш URL оповещения.
Ключи параметров должны начинаться с ap_ и содержать только латинские символы и цифры.
Значения параметров могут содержать только латинские буквы, цифры и символы '-', '_'. Например:
<input type="text" name="ap_name" value="ivanov">
<input type="text" name="ap_login" value="ivanov1971">

Формирование подписи в платежной форме

Подпись для платежной формы формируется путем нахождения MD5-хеша от строки
"ID Вашего магазина:Сумма платежа:Секретное слово 1:Номер заказа", пример на PHP:

md5('1011:100.11:secret1:154')

Пример платежной формы:

<?php
    $shop_id = '1011';
    $secret1 = 'secret1';
    $order_id = '154';
    $order_amount = '100.11';
    $sign = md5($shop_id.':'.$order_amount.':'.$secret1.':'.$order_id);
?>

<form method="GET" action="https://www.lite-kassa.ru/pay">
<input type="hidden" name="shop" value="<?php=$shop_id?>">
<input type="hidden" name="amount" value="<?php=$order_amount?>">
<input type="hidden" name="order" value="<?php=$order_id?>">
<input type="hidden" name="sign" value="<?php=$sign?>">
<input type="hidden" name="desc" value="Form pay for documentation">
<input type="submit" name="pay" value="Оплатить">
</form>

Оповещение о платеже

После успешной оплаты, на ваш URL оповещения будут отправлены HTTP данные.

Опять же! При использовании интеграции, название параметров соответствуют вашей старой платежной системы.
(за доп. помощью обращайтесь в в службу поддержки)

Описание параметров

SHOP_ID ID Вашего магазина
AMOUNT Сумма заказа
ORDER_ID Ваш номер заказа
INV_ID Номер операции Lite-Kassa
P_EMAIL Email плательщика
CUR_ID ID электронной валюты, которой был оплачен заказ (список валют)
SIGN Подпись (методика формирования подписи в данных оповещения)
ap_key Дополнительные параметры с префиксом ap_ переданные в форму оплаты

Подтверждение заявки

Для проверки успешной обработки платежа в вашем URL оповещения выводите/возвращайте текст со словом OK

Внимание! Ответ также может соответствовать требованиям вашей прошлой платежной системы, если вы используете интеграцию.

В противном случае Lite-Kassa будет повторять отправку оповещения до тех пор, пока не получит нужного ответа.
(если в настройках указано)

Проверка IP

Рекомендуем так же проверять IP адрес сервера отправляющего Вам информацию, наши IP адреса - 194.49.121.46, 185.151.63.111   (список может обновляться)

Пример функции на PHP:

function getIP() {
    if (isset($_SERVER['HTTP_CF_CONNECTING_IP'])) return $_SERVER['HTTP_CF_CONNECTING_IP'];
    if (isset($_SERVER['HTTP_X_FORWARDED_FOR'])) return $_SERVER['HTTP_X_FORWARDED_FOR'];
    if (isset($_SERVER['HTTP_X_REAL_IP'])) return $_SERVER['HTTP_X_REAL_IP'];
    return $_SERVER['REMOTE_ADDR'];
}
if (!in_array(getIP(), array('194.49.121.46', '185.151.63.111'))) {
    die("hacking attempt!");
}

Пример обработчика платежа

//Секретное слово #2
$secret2 = 'secret2';

function getIP() {
    if (isset($_SERVER['HTTP_X_REAL_IP'])) return $_SERVER['HTTP_X_REAL_IP'];
    return $_SERVER['REMOTE_ADDR'];
}
if (!in_array(getIP(), array('194.49.121.46', '185.151.63.111'))) {
    die("hacking attempt");
}

$sign = md5($_REQUEST['SHOP_ID'].':'.$_REQUEST['AMOUNT'].':'.$secret2.':'.$_REQUEST['ORDER_ID']);

if ($sign != $_REQUEST['SIGN']) {
    die("wrong sign");
}

//Так же, рекомендуется добавить проверку на сумму платежа и не была ли эта заявка уже оплачена или отменена
//Оплата прошла успешно, можно проводить операцию.

die('OK');

Формирование подписи в скрипте оповещения

Подпись для скрипта оповещения формируется путем нахождения MD5-хеша от строки
"ID Вашего магазина:Сумма платежа:Секретное слово 2:Номер заказа", пример на PHP:

md5($_REQUEST['SHOP_ID'].':'.$_REQUEST['AMOUNT'].':secret2:'.$_REQUEST['ORDER_ID'])

Список доступных валют

Название Метод
Яндекс.Деньги ym
WebMoney wm
QIWI кошелек qiwi
Payeer payeer
Банковская карта card
Bitcoin btc
МТС mts
Мегафон megafon
Теле2 tele2
Билайн beeline
Терминалы России qterminal

Интеграция

Режим интеграции сделан для упрощенного перехода с другого сервиса приема платежей в наш сервис.

Для этого в настройках магазина выберите Интеграция свою старую платежную систему и внесите несколько изменений в свои скрипты оплаты.


Robokassa:

URL перехода Используйте https://www.lite-kassa.ru/pay вместо https://auth.robokassa.ru/Merchant/Index.aspx
MerchantLogin ID Вашего магазина на сервисе Lite-Kassa
InvId Номер счета в магазине (нужно указывать обязательно)
Пароль #1 Секретное слово #1 на сервисе Lite-Kassa
Пароль #2 Секретное слово #2 на сервисе Lite-Kassa
Все остальное оставьте без изменений

Freekassa:

URL перехода Используйте https://www.lite-kassa.ru/pay вместо http://www.free-kassa.ru/merchant/cash.php
MERCHANT_ID ID Вашего магазина на сервисе Lite-Kassa
Секретное слово Секретное слово #1 на сервисе Lite-Kassa
Секретное слово 2 Секретное слово #2 на сервисе Lite-Kassa
Все остальные данные оставьте без изменений

Interkassa:

URL перехода Используйте https://www.lite-kassa.ru/pay вместо https://sci.interkassa.com/
ik_co_id ID Вашего магазина на сервисе Lite-Kassa
ik_pm_no Номер или описание заказа (нужно указывать обязательно)
Secret Key Секретное слово #1 и секретное слово #2 на Lite-Kassa должны быть одинаковы.
Sign Key Внимание! Формировать нужно подпись по нашей схеме в MD5:
ik_sign = md5(ik_co_id:ik_am:SecretKey:ik_pm_no);
Все остальные данные оставьте без изменений

Payeer:

URL перехода Используйте https://www.lite-kassa.ru/pay вместо https://payeer.com/merchant/
m_shop ID Вашего магазина на сервисе Lite-Kassa
m_key Секретное слово #1 и секретное слово #2 на Lite-Kassa должны быть одинаковы.
m_sign Внимание! Формировать нужно подпись по следующей схеме:
arHash = array(
    m_shop,
    m_orderid,
    m_amount,
    m_key
);
m_sign = strtoupper(hash('sha256', implode(":", arHash)));
Все остальные данные оставьте без изменений

Unitpay:

currency
URL перехода Используйте https://www.lite-kassa.ru/pay/index/index/PUBLIC_KEY вместо https://unitpay.ru/pay/PUBLIC_KEY
PUBLIC_KEY ID Вашего магазина на сервисе Lite-Kassa
secretKeyСекретное слово #1 и секретное слово #2 на Lite-Kassa должны быть одинаковы.
currency Используйте RUB
signature Пример формирования цифровой подписи на PHP:
function getFormSignature($account, $currency, $desc, $sum, $secretKey) {
    $hashStr = $account.'{up}'.$currency.'{up}'.$desc.'{up}'.$sum.'{up}'.$secretKey;
    return hash('sha256', $hashStr);
}
Все остальные данные оставьте без изменений

API

API позволит вам интегрировать некоторые функции нашего сервиса в ваше приложение.


Все запросы отправляются методом GET / POST, ответ в формате JSON.

Внимание! Слишком частое обращение к API может привести к блокировке.

Проверка баланса

Для получения баланса, необходимо отправить запрос на URL:

https://www.lite-kassa.ru/api/v1/account/getBalance

Передаваемые параметры:

Параметр Значение Описание
token строка Ключ API, доступен в настройках профиля.

Пример запроса:

https://www.lite-kassa.ru/api/v1/account/getBalance?token=1sExK9ISODXdzqFJCKtKyHtqENFoHveu

Пример ответа:

{
   "balance" : "11.88"
}

Создание выплаты

Для создания выплаты, необходимо отправить запрос на URL:

https://www.lite-kassa.ru/api/v1/payouts/getRequest

Передаваемые параметры:

Параметр Значение Описание
token строка Ключ API, доступен в настройках профиля.
pay_type строка Код доступной платежной системы для выплаты.
amount число Сумма выплаты.
wallet строка Номер кошелька в допустимом формате.

Пример запроса:

https://www.lite-kassa.ru/api/v1/payouts/getRequest?token=1sExK9ISODXdzqFJCKtKyHtqENFoHveu&pay_type=qiwi&amount=100.00&wallet=74999905568

Пример ответа:

{
   "success" : "Payout created"
   "payout_id" : "32",
   "payout_wallet" : "74999905568",
   "payout_amount" : "97.00",
   "payout_status" : "wait",
   "payout_date_add" : "2018-02-08 17:08:42"
}

Информация о выплате

Для получения информации о выплате, необходимо отправить запрос на URL:

https://www.lite-kassa.ru/api/v1/payouts/getInfo

Передаваемые параметры:

Параметр Значение Описание
token строка Ключ API, доступен в настройках профиля.
payout_id число ID выплаты.

Пример запроса:

https://www.lite-kassa.ru/api/v1/payouts/getInfo?token=1sExK9ISODXdzqFJCKtKyHtqENFoHveu&payout_id=32

Пример ответа:

{
   "payout_id" : "32",
   "payout_wallet" : "74999905568",
   "payout_amount" : "97.00",
   "payout_status" : "success",
   "payout_date_add" : "2018-02-08 17:08:42"
}