Токенизация карты провайдером
Система UnonaPay полностью сертифицирована по стандартами PCI DSS, что позволяет предлагать торговцам сервис токенизации. Вместо хранения важной информации пользователя на своей стороне торговцы могут обменять данные карты на токен. Токен можно хранить и использовать для проведения последующих оплат.
Передача токена в запросах на оплату, авторизацию или выплату средств отменяет необходимость передавать данные карты. Система определит данные карты по ее токену и передаст их в сеть процессинга. Для подтверждения платежа покупателю потребуется ввести лишь номер CVC/CVV.
Если торговец использует сервис подписок, то для проведения рекуррентного платежа достаточно передать только токен карты.
Info
Для работы с данными карт торговцу необходимо соответствовать требованиям PCI DSS сертификации.
Создание токена карты
Отправьте POST
запрос на https://gateway.unonapay.com/credit_cards
со следующими параметрами:
Параметр | Тип | Описание |
---|---|---|
request | object | |
number * обязательный |
string (19) | Номер карты. |
holder * обязательный |
string (32) | Имя владельца карты. |
exp_month * обязательный |
integer | Месяц окончания срока действия карты, представленный двумя цифрами (например, 01). |
exp_year * обязательный |
integer | Год срока окончания действия карты, представленный четырьмя цифрами (например, 2026). |
contract * обязательный |
array | Массив, элементами которого могут быть параметры:recurring - UnonaPay вернет токен карты для осуществления последующих платежей без повторного ввода реквизитов карты. Пользователь, соглашаясь с условиями регулярного списания, единожды производит оплату, вводя реквизиты карты, включая проверочный код карты CVC/CVV и проходя авторизацию по протоколу 3-D Secure. |
Пример запроса на токенизацию карты
{
"request":{
"number":"4200000000000000",
"holder":"John Smith",
"exp_month":"05",
"exp_year":"2026",
"contract":["recurring"]
}
}
Обновление данных карты
Отправьте POST
запрос на https://gateway.unonapay.com/credit_cards/{token}
, где {token}
- это значение токена, со следующими параметрами:
Параметр | Тип | Описание |
---|---|---|
request | object | |
holder * обязательный |
string (32) | Имя владельца карты, как указано на карте. |
exp_month * обязательный |
integer | Месяц срока окончания действия карты, представленный двумя цифрами (например, 01). Должен быть передан вместе с exp_year . |
exp_year * обязательный |
integer | Год срока окончания действия карты, представленный четырьмя цифрами (например, 2026). Должен быть передан вместе с exp_month . |
Пример запроса на обновление данных карты
Для обновления данные holder
, exp_month
и exp_year
токена 23b48236ea85378ff899e33819ee31b1631ed8197dc254f9eb28c0011307cf32
POST запрос должен быть отправлен на https://gateway.unonapay.com/credit_cards/23b48236ea85378ff899e33819ee31b1631ed8197dc254f9eb28c0011307cf32
{
"request":{
"holder":"John Doe",
"exp_month":"01",
"exp_year":"2026"
}
}
Ответ
Ответ UnonaPay на запрос токенизации карты или обновления данных карты будет включать следующие параметры:
Параметр | Тип | Описание |
---|---|---|
holder * обязательный |
string | Имя владельца карты, взятое из запроса. |
brand * обязательный |
string | Определенный бренд карты: visa , master , jcb , discover , dinersclub , amex или unionpay . |
first_1 * обязательный |
string | Первая цифра карты. |
last_4 * обязательный |
string | Последние 4 цифры карты. |
stamp * обязательный |
string | Хэш карты. Постоянная величина, даже если дата окончания действия карты или владелец изменены. |
token * обязательный |
string | Токен карты. Позволяет сохранять данные клиентов и производить оплату, когда они делают покупку, или вы возобновляете свои услуги. |
exp_month * обязательный |
integer | Месяц окончания срока действия карты, представленный двумя цифрами (например, 01). |
exp_year * обязательный |
integer | Год срока окончания действия карты, представленный четырьмя цифрами (например, 2026). |
Пример ответа
{
"holder":"John Doe",
"stamp":"a825df7faba8804619aef7a6d5a5821ec292fce04e3e43933ca33d0692df90b4",
"brand":"visa",
"last_4":"0000",
"first_1":"4",
"token":"7ba647e7013b5cb9df39f17c375783aef81bc8c20f221b962becbd0686cc33af",
"exp_month":1,
"exp_year":2026
}