Верификация на платежной странице

Запрос Verify используется для вызова страницы wayforpay и проведения  верификации карты клиента.

Параметры запроса

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

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца.

Строка, подлежащая HMAC_MD5, генерируется путем конкатенации парамаетров merchantAccount, merchantDomainName, orderReference, amount, currency разделенных “;” (точка с запятой) в кодировке UTF-8

 

Параметр

Описание

Обязательное

merchantAccount

Идентификатор продавца. Присваивается Вам со стороны WayForPay

да

merchantAuthType

Тип авторизации. Может принимать одно из следующих значений:

 - simpleSignature (по умолчанию)

нет

merchantDomainName

Доменное имя веб-сайта торговца

да

merchantSignature

Подпись запроса

да

apiVersion

Версия протокола.Значение по-умолчанию: 1

да

returnUrl

URL, на который система должна перенаправлять клиента с результатом платежа. 

*В случае отсутствия параметра переадресация происходит на страницу результата оплаты checkout psp

да

serviceUrl

URL, на который система должна отправлять ответ с результатом платежа напрямую мерчанту

нет

orderReference

Уникальный номер заказа в системе торговца

да

amount

Сумма verify

0 - для генерации свободной суммы на стороне wayforpay, в пределах 1-5грн.

да

currency

Валюта verify: UAH

да

clientEmail

Email клиента

нет

clientPhone

Номер телефона клиента

нет

clientCountry

Страна клиента

нет

clientAddress

Адрес клиента

нет

clientCity

Город клиента

нет

clientState

Штат/Область клиента

нет

clientZipCode

Почтовый индекс клиента

нет

 

Параметры ответа

Параметр

Описание

Пример

merchantAccount

Идентификатор продавца

test_merchant

orderReference

Уникальный номер заказа в системе торговца

1212dd1

merchantSignature

hash_hmac

 

amount

Сумма заказа

100

currency

Валюта заказа

UAH

email

email плательщика

email@mail.com

phone

Номер телефона плательщика

+38063-333-33-33

createdDate

Дата создания запроса в psp (UTC)

123456789

processingDate

Дата процессирования транзакции (UTC)

12345678

cardPan

Маскированный номер карты (44****4444)

42****4242

cardType

Типа карты: Visa/MasterCard

Visa

issuerBankCountry

Страна карты

Ukraine

issuerBankName

Имя Банка карты

PrivatBank

recToken

Токен карты для рекарринговых списаний

121213321-3213213-3213213-321-3

transactionStatus

статус транзакции

Approved

reason

Причина отказа

Ok

reasonCode

Код отказа

1100

fee

Комиссия psp

0.00

paymentSystem

Платежная система, через которую был осуществлен платеж.

card

Аутентификация запросов

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца.

Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров merchantAccount, orderReference, amount, currency разделенных “;” (точка с запятой) в кодировке UTF-8

 

Пример HTTP POST запроса:

{
"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"
}

 

Уведомление мерчанта о статусе транзакции

Для авторизованных и проверенных заказов (а также при смене статуса заказа) серевер WayForPay направляет на serviceUrl запрос (HTTP_POST) включающий в себя данные заказа.
Данная информация дополняется контрольной подписью HMAC_MD5.
В случае, если WayForPay НЕ получит корректный ответ от сервера торговца, то система будет направлять запросы в течении 4-х суток или до получения правильного ответа.

 

Пример запроса на serviceUrl
{
"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"
}

 

Система WayForPay ожидает получить от сервера торговца следующий ответ:

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца.

Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров orderReference, status, time разделенных “;” (точка с запятой) в кодировке UTF-8

 

Пример корректного ответа от мерчанта
{
"orderReference":"DH783023",
"status":"accept",
"time":1415379863,
"signature":""
}