Переказ коштів з карт на рахунок

Продукти

Галузеві рішення

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

Тарифи

Інформація

Увійти

Приватний

Переказ коштів з карт на рахунок

Прийом оплати від клієнта за допомогою методу p2p debit

Схема роботи API p2p debit

Формування запиту до API при самостійній інтеграції:

Необхідні URL для роботи в залежності від обраної моделі:

https://www.liqpay.ua/api/request — Server-Server;
https://www.liqpay.ua/api/3/checkout — Client-Server;

Для виклику API LiqPay необхідно передати параметри data і signature (Server - Server) POST методом або перенаправити клієнта (Client-Server) використовуючи POST метод, де:

data

- json рядок з параметрами APIs закодована функцією base64, base64_encode( json_string ),

signature

- унікальний підпис кожного запиту base64_encode( sha1( private_key + data + private_key) ),

base64_encode

- повертає рядок, закодований методом base64,

sha1

- повертає хеш у вигляді бінарного рядку з 20 символів.

Формування data і signature, приклад:

Для підключення прийому оплати через LiqPay, формуємо json рядок з параметрами виклику апі, де:

Parameter	Required	Type	Description
version	Required	Number	Версія API. Наприклад: 3
public_key	Required	String	Публічний ключ - ідентифікатор створеної компанії. Наприклад: i00000000
private_key	Required	String	Приватний ключ створеної компанії (не надається нікому крім Вашого розробника). Наприклад: a4825234f4bae72a0be04eafe9e8e2bada209255
action	Required	String	Тип операції. Можливі значення: pay - платіж, hold - блокування коштів на рахунку відправника, subscribe - регулярний платіж, paydonate - пожертва, auth - предавторізація картки
amount	Required	Number	Сума платежу. Наприклад: 5, 7.34
currency	Required	String	Валюта платежу. Можливі значення:USD, EUR, UAH. Додаткові валюти можуть бути встановлені за запитом компанії
description	Required	String	Призначення платежу
order_id	Required	String	Унікальний ID покупки у Вашому магазині. Максимальна довжина 255 символів

Більше параметрів в документації

Інструмент формування data і signature

Приклад створення json_string:

json_string =

{"public_key":"i00000000","version":"3","action":"pay","amount":"3","currency":"UAH","description":"test","order_id":"000001"}

Приклад кодування json_string функцією base64_encode, компанія отримує data:

data = eyJwdWJsaWNfa2V5IjoiaTAwMDAwMDAwIiwidmVyc2lvbiI6IjMiLCJhY3Rpb24iOiJwYXkiLCJhbW91bnQiOiIzIiwiY3VycmVuY3kiOiJVQUgiLCJkZXNjcmlwdGlvbiI6InRlc3QiLCJvcmRlcl9pZCI6IjAwMDAwMSJ9

Приклад формування signature, компанія формує рядок sign_string шляхом конкатенації private_key + data + private_key:

sign_string = a4825234f4bae72a0be04eafe9e8e2bada209255eyJwdWJsaWNfa2V5IjoiaTAwMDAwMDAwIiwidmVyc2lvbiI6IjMiLCJhY3Rpb24iOiJwYXkiLCJhbW91bnQiOiIzIiwiY3VycmVuY3kiOiJVQUgiLCJkZXNjcmlwdGlvbiI6InRlc3QiLCJvcmRlcl9pZCI6IjAwMDAwMSJ9a4825234f4bae72a0be04eafe9e8e2bada209255

Після застосування функцій base64_encode( sha1( sign_string) ) отримуємо рядок:

signature = wR+UZDC4jjeL/qUOvIsofIWpZh8=

Приклад відправки запиту до LiqPay:

1.Для перенаправлення клієнта на сторінку оплати LiqPay (Client - Server) необхідно сформувати HTML-форму:

2.Для взаємодії (Server - Server) отримані data і signature необхідно відправити на url https://www.liqpay.ua/api/request:

curl --silent -XPOST https://www.liqpay.ua/api/request --data-
urlencodedata="eyJwdWJsaWNfa2V5IjoiaTAwMDAwMDAwIiwidmVyc2lvbiI6IjMiLCJhY3Rpb24iOiJwYXkiLCJhbW91bnQiOiIzIiwiY3VycmVuY3kiOiJVQUgiLCJkZXNjcmlwdGlvbiI6InRlc3QiLCJvcmRlcl9pZCI6IjAwMDAwMSJ9"/>
--data-urlencode
signature="wR+UZDC4jjeL/qUOvIsofIWpZh8="

3.Статус операції буде відправлений на server_url

4.Успішне завершення оплати

Параметри для формування data:

Основні

Parameter	Required	Type	Description
version	Required	Number	Версія API. Поточне значення - 3
public_key	Required	String	Публічний ключ - ідентифікатор магазину. Отримати ключ можна в налаштуваннях магазину
action	Required	String	p2pdebit
amount	Required	Number	Сума платежу. Наприклад: 5, 7.34
card	Required	String	Номер картки платника
card_cvv	Required	String	CVV/CVV2
card_exp_month	Required	String	Місяць терміну дії картки платника. Наприклад: 08
card_exp_year	Required	String	Рік терміну дії картки платника. Наприклад: 19
card_token	Required	String	Токен картки платника. Наприклад: B5BВB0D00B88B00ED00A00D0D (При використанні токену дані картки передавати не потрібно)
currency	Required	String	Валюта платежу. Можливі значення: USD, EUR, UAH
description	Required	String	Призначення платежу
order_id	Required	String	Унікальний ID покупки у Вашому магазині. Максимальна довжина 255 символів
phone	Required	String	Телефон платника. На цей номер буде відправлений OTP пароль підтвердження платежу та підвязаний кабінет платника LiqPay. Телефон вказується в міжнародному форматі (Україна +380). Наприклад: +380950000001 (з +) або 380950000001 (без +)
language	Optional	String	Мова клієнта uk, en
prepare	Optional	String	Попередня підготовка платежу. Цей режим дозволяє визначити чи заповнені всі дані , чи потрібна 3DS перевірка картки, чи не перевищено ліміт. Гроші з картки платника не списуються. Для включення режиму необхідно передати значення 1, а для роботи з DCC (dynamic currеncy conversion) - значення tariffs
recurringbytoken	Optional	String	Цей параметр дозволяє генерувати card_token платника, який ви отримаєте в callback запиті на server_url. card_token дозволяє проводити платежі без введення реквізитів картки платника, використовуючи API paytoken. Для отримання card_token необхідно передати в запиті значення 1
result_url	Optional	String	URL у Вашому магазині на який покупця буде переадресовано після завершення покупки. Максимальна довжина 510 символів
server_url	Optional	String	URL API в Вашому магазині для повідомлень про зміну статусу платежу (сервер -> сервер). Максимальна довжина 510 символів. Детальніше
sandbox	Required	String	Включає тестовий режим. Кошти з картки платника не списуються. Для включення тестового режиму необхідно передати значення 1. Всі тестові платежі будуть мати статус sandbox - успішний тестовий платіж.

Параметри відправника:

Parameter	Required	Type	Description
sender_first_name	Optional	String	Ім'я відправника
sender_last_name	Optional	String	Прізвище відправника
phone	Required	String	Телефон платника
sender_email	Optional	String	Електронна адреса
sender_country_code	Required	String	Код країни відправника. Цифровий ISO 3166-1 код
sender_city	Required	String	Місто відправника
sender_address	Required	String	Адреса відправника
sender_state	Optional	String	Платіжна адреса. Код регіону відправника. Цифровий ISO 3166-2 код. Для України ISO 3166-2:UA
sender_shipping_state	Optional	String	Адреса доставки. Код регіону відправника. Цифровий ISO 3166-2 код. Для України ISO 3166-2:UA
sender_postal_code	Required	String	Поштовий індекс відправника
mpi_eci	Required	Number	Можливі значення: 5 - транзакція пройшла з 3DS (емітент і еквайєр підтримують технологію 3D-Secure), 6 - емітент картки платника не підтримує технологію 3D-Secure, 7 - операція пройшла без 3D-Secure
mpi_cres	Required	String	Значення, що повертається ACS сторінкою емітента після автентифікації власника картки