Receiving customer data (GET_CLIENT)

Запрос позволяет получать Кредитным организациям данные 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

email владельца карты

email@mail.com

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
}
]
}​