Приватный
Создание компании
Регистрация новой компании в LiqPay для агентской схемы

Формирование запроса к API при самостоятельной интеграции:
Пример использования SDK:
#!/bin/bash
PUBLIC_KEY='your_public_key'
PRIVATE_KEY='your_private_key'
API_URL='https://www.liqpay.ua/api/request'
JSON="{ 
	\"action\" : \"agent_shop_create\",
    \"version\" : 3,
    \"public_key\" : \"${PUBLIC_KEY}\", 
    \"phone\" : \"380950000001\",
    \"order_id\" : \"order_id_1\",
    \"card\" : \"4731195301524634\",
    \"card_exp_month\" : \"03\",
    \"card_exp_year\" : \"22\",
    \"card_cvv\" : \"111\",
    \"site\" : \"agent1.site.com\",
    \"description\" : \"site description\",
    \"email\" : \"email@gmail.com\",
    \"name\" : \"Site name\"
}"
# 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'         => 'agent_shop_create',
'version'        => '3',
'phone'          => '380950000001',
'site'           => 'agent1.site.com',
'description'    => 'site description',
'email'          => 'email@gmail.com',
'name'           => 'Site name',
'card'           => '4731195301524634',
'card_exp_month' => '03',
'card_exp_year'  => '22',
'card_cvv'       => '111'
));
HashMap<String, String> params = new HashMap<String, String>();
params.put("action", "agent_shop_create");
params.put("version", "3");
params.put("phone", "380950000001");
params.put("site", "agent1.site.com");
params.put("description", "site description");
params.put("email", "email@gmail.com");
params.put("name", "Site name");  
params.put("card", "4731195301524634");
params.put("card_exp_month", "03");
params.put("card_exp_year", "22");
params.put("card_cvv", "111");

LiqPay liqpay = new LiqPay(PUBLIC_KEY, PRIVATE_KEY);
HashMap<String, Object> res = liqpay.api("request", params);    
System.out.println(res.get("result"));
from liqpay import LiqPay

liqpay = LiqPay(public_key, private_key)
res = liqpay.api("request", {
"action"         : "agent_shop_create",
"version"        : "3",
"phone"          : "380950000001",
"site"           : "agent1.site.com",
"description"    : "site description",
"email"          : "email@gmail.com",
"name"           : "Site name",
"card"           : "4731195301524634",
"card_exp_month" : "03",
"card_exp_year"  : "22",
"card_cvv"       : "111"
})
liqpay = Liqpay::Liqpay.new(
:public_key  => 'public_key',
:private_key => 'private_key'
)
res = liqpay.api("request", {
:action         => "agent_shop_create",
:version        => "3", 
:phone          => "380950000001",    
:site           => "agent1.site.com",
:description    => "site description",
:email          => "email@gmail.com",
:name           => "Site name",
:card           => "4731195301524634",
:card_exp_month => "03",
:card_exp_year  => "22",
:card_cvv       => "111"
})
LiqPay = liqpay:init(PublicKey, PrivateKey),
Res = liqpay:api("request", [
{<<"action">>, <<"agent_shop_create">>},
{<<"version">>, <<"3">>}, 
{<<"phone">>, <<"380950000001">>}, 
{<<"site">>, <<"agent1.site.com">>}, 
{<<"description">>, <<"site description">>}, 
{<<"email">>, <<"email@gmail.com">>}, 
{<<"name">>, <<"Site name">>}, 
{<<"card">>, <<"4731195301524634">>}, 
{<<"card_exp_month">>, <<"03">>}, 
{<<"card_exp_year">>, <<"22">>}, 
{<<"card_cvv">>, <<"111">>}
], LiqPay).
var LiqPay = require('liqpay');
var liqpay = new LiqPay(public_key, private_key);
liqpay.api("request", {
"action"         : "agent_shop_create",
"version"        : "3",
"phone"          : "380950000001",
"site"           : "agent1.site.com",
"description"    : "site description",
"email"          : "email@gmail.com",
"name"           : "Site name",
"card"           : "4731195301524634",
"card_exp_month" : "03",
"card_exp_year"  : "22",
"card_cvv"       : "111"
}, function( json ){
console.log( json.result );
});
my $liqpay = Liqpay->new($public_key,$private_key);
my $res = $liqpay->api("request",
{
'action'         => 'agent_shop_create',
'version'        => '3',  
'phone'          => '380950000001',     
'site'           => 'agent1.site.com',
'description'    => 'site description',
'email'          => 'email@gmail.com',
'name'           => 'Site name',
'card'           => '4731195301524634',
'card_exp_month' => '03',
'card_exp_year'  => '22',
'card_cvv'       => '111'
}
);
Init("my_public_key", "my_private_key")
Api("request", map[string]interface{}{
    "action": "agent_shop_create",
    "version": 3,
    "public_key": "PublicKey", 
    "phone": "380950000001",
    "card": "4731195301524634",
    "card_exp_month": "03",
    "card_exp_year": "22",
    "card_cvv": "111",
    "site": "agent1.site.com",
    "description": "site description",
    "email": "email@gmail.com",
    "name": "Site name",
})
Параметры для формирования data:
Основные
Parameter Required Type Description
version Required Number Версия API. Текущее значение - 3
public_key Required String Публичный ключ - идентификатор магазина. Получить ключ можно в настройках магазина
action Required String agent_shop_create
card Required* String Номер карты для приема платежей в этом магазине
card_cvv Required* String CVV/CVV2
card_exp_month Required* String Месяц срока действия карты
card_exp_year Required* String Год срока действия карты
description Required String Описание магазина
email Required String Email магазина
name Required String Название магазина
phone Required String Номер телефона магазина
site Required String URL сайта магазина
iban Required** String IBAN для приема платежей в этом магазине. Максимальная длина 34 символа
company Required** String Наименование счета
okpo Required** String ОКПО счета
amount_procent_agent Optional Number Комиссия агента в процентах
amount_static_agent Optional* Number Комиссия агента статическая
currency_static_agent Optional* String Валюта статической комиссии агента
can_reports Optional String Позволяет владельцу главной компании просматривать истории платежей созданной компании, передать значение true
can_checkout_edit Optional String Позволяет владельцу главной компании редактировать настройки страницы оплаты созданной компании, передать значение true
logo Optional String URL логотипа магазина
public_phone Optional String Публичный телефон магазина
Параметры для агрераторов
Укажите данные предприятия, для которого создаётся компания
law_okpo Required String ЕГРПОУ предприятия. Максимальная длина 255 символов
law_name Optional* String Название предприятия. Максимальная длина 255 символов
law_contacts Optional* Object Контактные данные предприятия
law_cto_info Optional* Object Информация о руководителе предприятия
law_owners_info Optional* Array Информация о собственнике(-ах) предприятия
* Параметры обязательны для клиентов, которые обслуживаются не в ПриватБанке
Контактные данные предприятия (объект law_contacts)
phone Optional String Контактный телефон предприятия
email Optional String Контактный email предприятия
Информация о руководителе предприятия (объект law_cto_info)
name Optional String ФИО руководителя предприятия
inn Optional String ИНН руководителя предприятия
birth_date Optional String Дата рождения руководителя предприятия. Введите дату в таком формате: 2015-03-31
citizenship Optional String Гражданство руководителя предприятия. Напишите название страны латинскими буквами. Пример: Ukraine
Информация о собственнике(-ах) предприятия (массив law_cto_info)
В массив можно передать до трёх объектов с данными о собственниках.
name Optional String ФИО собственника предприятия
inn Optional String ИНН собственника предприятия
birth_date Optional String Дата рождения собственника предприятия. Введите дату в таком формате: 2015-03-31
citizenship Optional String Гражданство собственника предприятия. Напишите название страны латинскими буквами. Пример: Ukraine
share_in_capital Optional String Доля собственника в уставном капитале предприятия
Пример ответа:
{
"status": "success",
"public_key": "i000000000",
"private_key": "wGsqoko5412LcD0vB215XK2wQSgLDVBrsaPIRi6"
}
Параметры ответа
Parameter Type Description
private_key String Приватный ключ компании
public_key String Публичный ключ магазина
status String Статус платежа.
Возможные значения:
Конечные статусы платежа
error Неуспешный платеж. Некорректно заполнены данные
failure Неуспешный платеж
success Успешный платеж
Cтатусы требующие подтверждения платежа
3ds_verify Требуется 3DS верификация.
Для завершения платежа, требуется выполнить 3ds_verify
cvv_verify Требуется ввод CVV карты отправителя.
Для завершения платежа, требуется выполнить cvv_verify
otp_verify Требуется OTP подтверждение клиента. OTP пароль отправлен на номер телефона Клиента.
Для завершения платежа, требуется выполнить otp_verify