Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Описание:

Данный метод позволяет получить преимущество при погашении клиентами кредитных организаций используя пониженный тариф по Дебету.

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

...

Обязательные требования к сайту:

...

API Endpoint (cсылка для отправки запросов):

...

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

Параметр

Значение

Описание

Особенности

Обязательно

action

DEBIT_PREPARE

Код платежного метода

 

Да

async

"Y" или "N"

Включить асинхронный режим

В асинхронном режиме обязательное использование коллбеков.
По умолчанию значение "N"

Нет

channel_id

String

Дополнительный платежный канал

Позволяет отправить платежи на другой банковский терминал

Нет

client_key

String

API ключ мерчанта

Ключ предоставляется на почту мерчанту

Да

order_id

String

ID платежа в системе мерчанта

Max 32 символа

Да

order_amount

Number

Сумма платежа

Tip

Верный вариант

1000.00

Warning

Неверные варианты

1000
1000.0
1,000.0
1,000.00

Да

order_currency

UAH

Валюта платежа

Info

Оплата возможна только в национальной валюте гривне

Да

order_description

String

Описание платежа

Note

Для кириллических символов необходимо использовать формат UTF-8

Max 255 символов

Да

payer_first_name

String

Имя плательщика

Max 32 символа без пробелов

Да

payer_last_name

String

Фамилия плательщика

Max 32 символа без пробелов

Да

payer_address

String

Адрес плательщика

Max 256 символа
Укажите "NA", если нет данных

Да

payer_country

String

Страна плательщика

Стандарт ISO 3166-1 alpha-2
В формате "ХХ"
2 символа
Укажите "NA", если нет данных

Да

payer_state

String

Штат плательщика

Note

Обязательный параметр для стран US, CA, AU

Стандарт ISO 3166-2
В формате "ХХ"
2 символа
Укажите "NA", если нет данных

Да

payer_city

String

Город плательщика

Max 32 символа
Укажите "NA", если нет данных

Да

payer_zip

String

Почтовый индекс плательщика

Max 32 символа
Укажите "NA", если нет данных

Да

payer_email

String

Почта плательщика

Max 255 символа

Да

payer_phone

Number

Номер телефона плательщика

Note

Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то:

  1. обязательный формат телефона 380…

  1. номер телефона должен соответствовать финансовому номеру привязанному к карте

Да

payer_ip

Number

IP-адрес плательщика

В формате "ХХХ.ХХХ.ХХХ.ХХХ"

Note

IPv6 на данный момент не поддерживается

Да

card_number

Number

Полный номер карты

В формате "ХХХХХХХХХХХХХХХХ"
16 символов

Да

card_exp_month

Number

Месяц окончания срока действия карты

В формате "ХХ"
2 символа

Да

card_exp_year

Number

Год окончания срока действия карты

В формате "ХХХХ"
4 символа

Да

card_cvv2

Number

Проверочный код на карте

В формате "ХХХ"
3 символа

Да

req_token

"Y" или "N"

Для получения card_token

По умолчанию "N"

Да

hash

String

Контрольная подпись

Code Block
languagephp

Да

...

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

Для просмотра примера раскройте список

Получение статуса транзакции в Callback и Response:

Tip

Ответы будут поступать с наших IP:
78.140.172.231
62.113.223.114
78.140.135.130
167.99.253.235

...

  • Коллбеки в формате JSON

  • Basic Authorization

...

Синхронный режим:

Для просмотра примера раскройте список

...

Асинхронный режим:

Данный режим активируется при передаче ‘async’='Y'. В этом режиме обязательно необходимо принимать callback на ваш callback url.

Для просмотра примера раскройте список

...

Дополнительная проверка оплаты:

Для получения информации об оплате в случае, если ваша система не смогла принять Callback, Response или по другой причине, можно воспользоваться дополнительными API запросами проверки: