Верифікація картки (Verify)

Верифікація карти клієнта - забезпечує прив'язку карти, отримання токена карти для подальших платежів без повторного введення клієнтом карткових даних. Також, дозволяє перевірити чи активна картка для розрахунків і здійснити перевірку того, що ймовірно банківська карта належить власнику карти.

Запит Verify використовується для виклику сторінки WayForPay і проведення верифікації карти клієнта і отримання токена карти в разі успішної верифікації.

Доступні варіанти верифікації:

• Верифікація картки з блокуванням суми на картці клієнта і введенням заблокованої суми

• Верифікація картки з блокуванням суми і підтвердженням введення 3D Secure коду (в разі якщо карта підтримує 3D Secure).

• Верифікація картки без списання грошей, з підтвердженням введення Lookup коду.

• Верифікація картки без списання грошей і без підтвердження з боку клієнта.

• Верифікація картки без списання грошей з картки, з підтвердженням введення 3D Secure коду (в разі якщо карта підтримує 3D Secure).

Верифікація картки з блокуванням суми на картці клієнта і введенням заблокованої суми

Дозволяє підтвердити, що клієнт має доступ до картки в разі введення клієнтом правильної суми, яка була заблокована на картці (це дозволяє припускати, що карту додає власник картки). У разі відсутності грошей на картці, верифікація буде неуспішною.

Як працює?

1. На першому Кроці клієнт вводить реквізити картки, система блокує на картці клієнта випадкову суму від 1 до 5 грн.

2. На другому Кроці клієнт підтверджує - вводить заблоковану суму на своїй картці, яку може дізнатися в своєму банкінгу або з смс від банку про блокування грошей на карті.

3. У разі успішного підтвердження заблокованої суми система повертає токен картки клієнта.

Результатом обробки запиту є блокування коштів на картці клієнта і автоматичне розблокування коштів через 15 хвилин.

Для використання даного виду верифікації необхідно в запиті Verify передати:

•  paymentSystem = card
•  verifyType = confirm

Перейти до загальних параметрів запиту та відповіді

Верифікація картки з блокуванням суми, і підтвердженням введення 3d Secure коду (для карток які підтримують 3D Secure)

Дозволяє отримати токен карти шляхом блокування суми на карті і запитом введення 3D Secure коду, відправленого банком-емітентом карти. Якщо карта не підтримує 3D Secure перевірку, сума буде заблокована без підтвердження.

У разі відсутності грошей на карті, верифікація буде неуспішною.

Як працює?

1. На першому Кроці клієнт вводить реквізити карти, система блокує на карті клієнта випадкову суму від 1 до 5 грн.

2. Для карт з 3d secure Другий Крок - клієнт підтверджує - вводить 3D Secure код, який може дізнатися в своєму банкінгу або з смс або підтвердити блокування суми в додатку банку. У разі успішного підтвердження заблокованої суми система повертає токен картки клієнта.

3. Для карток які не підтримують 3D Secure в разі успішного підтвердження заблокованої суми система повертає токен картки клієнта.

Результатом обробки запиту є блокування коштів на картці клієнта і автоматичне розблокування коштів через 15 хвилин.

Для використання даного виду верифікації необхідно в запиті Verify передати:

•  paymentSystem = card
•  verifyType = simple

Перейти до загальних параметрів запиту та відповіді

Верифікація карти без списання грошей з підтвердженням введення Lookup коду

Верифікація картки відбувається без списання грошей, але з підтвердженням введення lookup коду, який надсилає банк в смс або в push повідомленні в додаток банкінгу. Дозволяє верифікувати карту без наявності на ній коштів.

Як працює?

1. На першому Кроці клієнт вводить реквізити картки, система відправляє запит в банк клієнта на відправку йому lookup коду.

2. На другому Кроці клієнт підтверджує - вводить код, який банк йому відправив в смс  повідомлення або в push повідомленні в застосунок банкінгу.

3. У разі введення правильного lookup коду система повертає токен картки клієнта.

Для використання даного виду верифікації необхідно в запиті Verify передати:

• paymentSystem = lookupCard
•  verifyType = confirm

Перейти до загальних параметрів запиту та відповіді

Верифікація карти без списання грошей і без підтвердження з боку клієнта

Дозволяє верифікувати карту без наявності на ній коштів. Клієнту достатньо буде ввести повні реквізити картки, система відправить запит в банк на перевірку валідності карти.

Як працює?

1. Клієнт вводить реквізити картки.

2. Система відправляє запит в банк і в разі валідності картки система повертає токен картки клієнта.

Для використання даного виду верифікації необхідно в запиті Verify передати:

•  paymentSystem = lookupCard
•  verifyType = simple

Перейти до загальних параметрів запиту та відповіді

Верифікація карти без списання грошей з картки (для карток які підтримують 3D Secure)

Дозволяє верифікувати карту без блокування на ній коштів,  для карток які підтримують технологію  3D Secure - шляхом запиту для введення 3D Secure коду, відправленого банком-емітентом карти.

Якщо карта не підтримує 3D Secure, верифікація карти буде без блокування на картці коштів.

Як працює?

1. На першому Кроці клієнт вводить реквізити карти

2. Для карток з 3D Secure:  Другий Крок - клієнт підтверджує - вводить 3D Secure код, який може дізнатися в своєму банкінгу або з смс/push. У разі успішного підтвердження 3D Secure система повертає токен картки клієнта.

3. Для карток які не підтримують 3D Secure. система відправляє запит в банк і в разі валідності картки система повертає токен картки клієнта.

Для використання даного виду верифікації необхідно в запиті Verify передати:

•  paymentSystem = card
•  verifyType = empty

Загальні параметри запиту та відповіді знаходяться нижче.

Параметри запиту

Запит c необхідними параметрами формується на стороні продавця та передається методом POST по протоколу HTTP на URL https://secure.wayforpay.com/verify

З метою підтвердження валідності даних повинно бути згенеровано і передано в запиті HMAC_MD5 контрольний підпис з використанням SecretKey торговця.

Рядок, що підлягає HMAC_MD5, генерується шляхом конкатенації парамаетров merchantAccount, merchantDomainName, orderReference, amount, currency розділених ";" (крапка з комою) в кодуванні UTF-8

{
"merchantAccount": "test_merch_n1",
"merchantDomainName": "merchant.com.ua",
"merchantAuthType": "SimpleSignature",
"merchantSignature": "9a9b6f197eea8319ee87c4b7079c4c28",
"orderReference": "VRF-PP-1445852171",
"amount": "0",
"currency": "UAH",
"clientEmail": "some@mail.com",
"clientPhone": "+38(066)0000000",
"returnUrl": "http://local.com/service",
"serviceUrl": "http://local.com/service",
"language": "RU"
}

{
"merchantAccount":"test_merchan_n1",
"orderReference":"DH783023",
"merchantSignature":"",
"amount":3.36,
"currency":"UAH",
"authCode":"541963",
"email":"client@mail.ua",
"phone":"380501234567",
"createdDate":12345678,
"processingDate":12345678,
"cardPan":"41****8217",
"cardType":"visa",
"issuerBankCountry":"980",
"issuerBankName":"Privatbank",
"recToken":"",
"transactionStatus":"WaitingAmountConfirm",
"reason":5105,
"reasonCode":"",
"fee":0,
"paymentSystem":"card"
}

{
"orderReference":"DH783023",
"status":"accept",
"time":1415379863,
"signature":""
}