Запрос позволяет получать Кредитным организациям данные Bankid по заемщикам, владельцам карт ПриватБанка и Абанка.
Параметры запроса
Запрос c необходимыми параметрами формируется на стороне торговца и передается методом POST по протоколу HTTP на URL https://api.wayforpay.com/api
В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца.
Строка, подлежащая HMAC_MD5, генерируется путем конкатенации парамаетров merchantAccount,card (merchantAccount,recToken) разделенных “;” (точка с запятой) в кодировке UTF-8
| Параметр | Описание | Обязательное |
|---|---|---|
| apiVersion | Версия протокола. Значение по-умолчанию: 1 | да |
| transactionType | GET_CLIENT | да |
| merchantAccount | Идентификатор продавца. Данное значение присваивается Вам со стороны WayForPay | да |
| merchantSignature | Подпись запроса | да |
| card | Номер карты 16 цифр | нет |
| recToken | Токен карты — для повторного списания без участия клиента (без передачи реквизитов карты) | нет |
Внимание! Должен быть обязательно передан один из параметров card или recToken.
Параметры ответа:
| Параметр | Описание | Пример |
|---|---|---|
| lastName | Фамилия владельца карты | Иванов |
| firstName | Имя владельца карты | Иван |
| middleName | Отчество владельца карты | Иванович |
| | email владельца карты | |
| phone | Номер телефона владельца карты | +380633333333 |
| birthDay | Дата рождения | 21.12.1980 |
| inn | ИНН владельца карты | 123456789 |
| sex | Пол | M |
| resident | Страна владельца карты | UA |
| processedDate | Время получения запроса. Формат utc timestamp | 1507294262 |
| modifiedDate | Время обработки. Формат utc timestamp | 1505692800 |
| addresses | Массив данных адресов клиента | |
| documents | Массив документов по клиенту | |
| reason | Причина отказа | Ok |
| reasonCode | Код отказа | 1100 |
| merchantSignature | hash_hmac |
Аутентификация запросов
В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца.
Строка, подлежащая HMAC_MD5, генерируется путем конкатенации парамаетров reasonCode;processingDate разделенных “;” (точка с запятой) в кодировке UTF-8
Пример запроса и ответа
Запрос
{
"APIVERSION":1,
"TRANSACTIONTYPE": "GET_CLIENT",
"MERCHANTACCOUNT": "TEST_MERCH_N1",
"MERCHANTSIGNATURE": "4F00E7C84B027B010A3FB54975A826B4",
"RECTOKEN": "55111111-1111-0000-9988-68C457123456"
}
Ответ
{
"REASONCODE": 1100,
"REASON": "OK",
"LASTNAME": "ИВАНОВ",
"FIRSTNAME": "ИВАН",
"MIDDLENAME": "ИВАНОВИЧ",
"PHONE": "+380123456789",
"EMAIL": "EMAIL@MAIL.COM",
"BIRTHDAY": "01.01.1980",
"INN": "123456789",
"SEX": "M",
"RESIDENT": "UA",
"PROCESSEDDATE": 1607894262,
"MODIFIEDDATE": 1605992800,
"ADDRESSES": [
{
"TYPE": "BIRTH",
"COUNTRY": "UA",
"STATE": NULL,
"CITY": NULL,
"STREET": "НЕТ УЛИЦЫ",
"HOUSE": NULL,
"FLAT": NULL,
"MODIFIEDDATE": 159828761
},
{
"TYPE": "FACTUAL",
"COUNTRY": "UA",
"STATE": "КИЕВСКАЯ",
"CITY": "КИЕВ",
"STREET": "КОВАЛЕВА",
"HOUSE": "100",
"FLAT": "70",
"MODIFIEDDATE": 1887622186
}
],
"DOCUMENTS": [
{
"TYPE": "PASSPORT",
"SERIES": "АА",
"NUMBER": "123456",
"ISSUE": "ШЕВЧЕНКОВСКИМ РО УМВД УКРАИНЫ В КИЕВСКОЙ ОБЛАСТИ",
"ISSUECOUNTRY": "UA",
"DATEISSUE": "1998-01-01",
"MODIFIEDDATE": 1456864446
}
]
}