Приватный
DCC
Прием оплаты клиента в валюте его карты

Схема работы API оплата картой server-server
Важно:
  1. Для получения курса и альтернативной суммы в финальный запрос с action = “pay” добавьте параметр prepare = “tariffs”. В ответе параметр dcc_allowed будет содержать данные по курсу и сумме в альтернативной валюте на текущий момент.
  2. Для выполнения операции с DCC в финальный запрос с action = “pay” добавьте параметр is_dcc_debit = “true”.
Формирование запроса к API при самостоятельной интеграции:
Параметры для формирования data:
Основные
Parameter Required Type Description
version Required Number Версия API. Текущее значение - 3
public_key Required String Публичный ключ - идентификатор магазина. Получить ключ можно в настройках магазина
action Required String pay
amount Required Number Сумма платежа.Например: 5, 7.34
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, RUB, UAH
description Required String Назначение платежа.
phone Required String Телефон плательщика. На этот номер будет отправлен OTP пароль подтверждения платежа. Телефон указывается в международном формате (Украина +380, Россия +7). Например: +380950000001 (с +) или 380950000001 (без +)
language Optional String Язык клиента ru, uk, en
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 - успешный тестовый платеж.
is_dcc_debit Optional Boolean true - транзакция будет проведена с использованием альтернативной суммы DCC.
false - транзакция будет проведена без DCC.
prepare Optional String tariffs Получить курс и альтернативную валюту DCC.
Параметры по отправителю
sender_address NEW Optional String Адрес отправителя
sender_city Optional String Город отправителя
sender_country_code Optional String Код страны отправителя. Цифровой ISO 3166-1 код
sender_first_name Optional String Имя отправителя
sender_last_name Optional String Фамилия отправителя
sender_postal_code Optional String Почтовый индекс отправителя
3DS параметры
mpi_md Optional String Параметр, возвращаемый страницей ACS MD.
Этот параметр передается, только если предварительно было использовано API MPI
mpi_pares Optional String Параметр, возвращаемый страницей ACS pares.
Этот параметр передается, только если предварительно было использовано API MPI
Пример ответа:
{
  "action": "pay",
  "payment_id": 165172,
  "status": "success",
  "version": 3,
  "type": "buy",
  "paytype": "card",
  "public_key": "i000000000",
  "acq_id": 414963,
  "order_id": "98R1U1OV1485849059893399",
  "liqpay_order_id": "NYMK3AE61501685438251925",
  "description": "description",
  "sender_phone": "380950000001",
  "sender_first_name": "first_name",
  "sender_last_name": "last_name",
  "sender_card_mask2": "473118*50",
  "sender_card_bank": "pb",
  "sender_card_type": "visa",
  "sender_card_country": 804,
  "dcc_allowed": [{
    "amount": 3.5984,
    "rate": 27.7905,
    "commission": 0.0,
    "currency": "USD"
  }],
  "ip": "8.8.8.8",
  "card_token": "CDRES215658546306B200061FCC53A86B",
  "amount": 100.0,
  "currency": "UAH",
  "sender_commission": 0.0,
  "receiver_commission": 0.0,
  "agent_commission": 0.0,
  "amount_debit": 100.0,
  "amount_credit": 100.0,
  "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": 0.0,
  "authcode_debit": "388000",
  "authcode_credit": "329007",
  "rrn_debit": "000663747000",
  "rrn_credit": "000663747003",
  "mpi_eci": "7",
  "is_3ds": false,
  "create_date": 1501685446633,
  "end_date": 1501685446633,
  "transaction_id": 165172
}
Параметры ответа
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 Дата завершения/изменения платежа
ip String IP адрес отправителя
is_3ds Boolean Возможные значения:
true - транзакция прошла с 3DS проверкой,
false - транзакция прошла без 3DS проверки
liqpay_order_id String Order_id платежа в системе LiqPay
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 Комиссия с получателя в валюте платежа
status String Возможные значения: activated - магазин активирован с возмещением, wait_accept - магазин активирован без возмещения
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_first_name String Имя отправителя
sender_last_name String Фамилия отправителя
sender_phone String Телефон отправителя
status String Статус платежа.
Возможные значения:
Конечные статусы платежа
error Неуспешный платеж. Некорректно заполнены данные
failure Неуспешный платеж
reversed Платеж возвращен
success Успешный платеж
Cтатусы требующие подтверждения платежа
3ds_verify Требуется 3DS верификация.
Для завершения платежа, требуется выполнить 3ds_verify
cvv_verify Требуется ввод CVV карты отправителя.
Для завершения платежа, требуется выполнить cvv_verify
otp_verify Требуется OTP подтверждение клиента. OTP пароль отправлен на номер телефона Клиента.
Для завершения платежа, требуется выполнить otp_verify
receiver_verify Требуется ввод данных получателя.
Для завершения платежа, требуется выполнить receiver_verify
sender_verify Требуется ввод данных отправителя.
Для завершения платежа, требуется выполнить sender_verify
Другие статусы платежа
wait_accept Деньги с клиента списаны, но магазин еще не прошел проверку. Если магазин не пройдет активацию в течение 180 дней, платежи будут автоматически отменены
wait_secure Платеж на проверке
transaction_id Number Id транзакции в системе LiqPay
type String Тип платежа
version Number Версия API. Текущее значение - 3
dcc_allowed Object Данные альтернативной суммы для оплаты с DCC:
amount Сумма платежа в альтернативной валюте
currency Альтернативная валюта
rate Курс конвертации
commission Комиссия по платежу в альтернативной валюте