Данный метод требует наличия PCI DSS сертификата или PCI Compliance (сканирование) .
Этот функционал будет активирован после вашего запроса в групповом чате. Также обязательно сообщите IP адреса, с которых будут отправляться запросы для добавления
в белый список.
Также рекомендуем ознакомиться с разделом /wiki/spaces/docs/pages/1319043121.
Ваш сайт должен работать по схеме HTTPS и поддерживать протокол TLS 1.2.
Описание
Данный функционал позволяет вам разместить платежную форму на вашей стороне, с вашим уникальным дизайном, и без перехода плательщика на нашу форму ввода карточных данных.
Верификация карты используется кредитными организациями для:
Подтверждения личности владельца карты
Получения токенов RC_TOKEN и CARD_TOKEN для последующих выплат и списаний. Детальнее в разделе Особенности токенов
После получения callback об успешной верификации необходимо провести возврат средств плательщику. Детальнее в разделе Возврат средств. Если вы используете /wiki/spaces/docs/pages/1319043121 возврат проводить не нужно.
Одну карту можно верифицировать несколько раз. Все RC_TOKEN и CARD_TOKEN полученные при каждой верификации будут разные и активные для дальнейшего использования.
Требования к сайту
Наличие PCI DSS сертификата или PCI Compliance (сканирования)
Разместить логотипы платежных систем Visa и Mastercard
Добавить логотипы PSP Platon
API параметры запроса
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/post-unq/
Параметр | Значение | Описание | Особенности | Обязательно |
---|---|---|---|---|
| SALE | Код платежного метода | ДА | |
| "Y" или "N" | Включить асинхронный режим | В асинхронном режиме обязательное использование коллбеков. | НЕТ |
| String | Дополнительный платежный канал | Значение “VERIFY_ZERO“ для нулевой верификации. Значение “VERIFY“ для обычной верификации со списанием. | ДА |
| String | API ключ мерчанта | Ключ предоставляется на почту мерчанту | ДА |
| String | ID платежа в системе мерчанта | Max 32 символа | ДА |
| Number | Сумма платежа | Верный вариант 1000.00 Неверные варианты 1000 | ДА |
| UAH | Валюта платежа | Оплата возможна только в национальной валюте гривне | ДА |
| String | Описание платежа | Для кириллических символов необходимо использовать формат UTF-8 Max 255 символов | ДА |
| String | Имя плательщика | Max 32 символа без пробелов | НЕТ |
| String | Фамилия плательщика | Max 32 символа без пробелов | НЕТ |
| String | Адрес плательщика | Max 256 символа | НЕТ |
| String | Страна плательщика | Стандарт ISO 3166-1 alpha-2 | НЕТ |
| String | Штат плательщика | Обязательный параметр для стран US, CA, AU Стандарт ISO 3166-2 | НЕТ |
| String | Город плательщика | Max 32 символа | НЕТ |
| String | Почтовый индекс плательщика | Max 32 символа | НЕТ |
| String | Почта плательщика | Max 255 символа | НЕТ |
| Number | Номер телефона плательщика | Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то: 1) обязательный формат телефона 380… 2) номер телефона должен соответствовать финансовому номеру привязанному к карте | НЕТ |
| Number | IP-адрес плательщика | В формате "ХХХ.ХХХ.ХХХ.ХХХ" IPv6 на данный момент не поддерживается | ДА |
| String | Номер електронного кошелька пользователя | Поле обязательно для типов бизнеса связаных с виртуальными активами | НЕТ |
| String | Ссылка по которой будет отправлен клиент после успешной оплаты при прохождении 3DS | Max 255 символов | ДА |
| Number | Полный номер карты | В формате "ХХХХХХХХХХХХХХХХ" | ДА |
| Number | Месяц окончания срока действия карты | В формате "ХХ" | ДА |
| Number | Год окончания срока действия карты | В формате "ХХХХ" | ДА |
| Number | Проверочный код на карте | В формате "ХХХ" | ДА |
| "Y" или "N" | Для получения card_token | По умолчанию "N" | ДА |
| "Y" или "N" | Для получения rc_id и rc_token | По умолчанию "N" | ДА |
| "Y" или "N" | По умолчанию "N" | НЕТ | |
| String | Контрольная подпись | md5( strtoupper( strrev(email). client_pass. strrev( substr(card_number,0,6). substr(card_number,-4) ) ) ) | ДА |
Примеры запроса
Для просмотра примера раскройте список
Тестирование
Проверка платежей
Получить информацию о платежах можно несколькими способами:
Используя Callback для автоматизации процесса зачисления в системе на вашей стороне
Нотификация в Telegram Bot об успешной оплате с деталями платежа сразу после списания
В вашем личном кабинете Platon
CSV файл с деталями платежей скачав в личном кабинете Platon
Банковский реестр на почту или ваш FTP
Работа с Callback
Рекомендуем ознакомиться с разделами:
Callback и Response (Синхронный режим)
Для просмотра примера раскройте список
Callback и Response (Асинхронный режим)
Данный режим активируется при передаче async = Y
. В этом режиме обязательно необходимо принимать callback на ваш callback url.
Для просмотра примера раскройте список