Перейти к концу метаданных
Переход к началу метаданных

 

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

Результатом обработки запроса является блокировка денежных средств на карте клиента и автоматическая разблокировка средств по истечению 60 минут .

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

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

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

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

 

Параметр

Описание

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

transactionType

VERIFY

 

merchantAccount

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

да

merchantAuthType

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

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

нет

merchantDomainName

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

да

merchantSignature

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

да

apiVersion

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

да

serviceUrl

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

нет

orderReference

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

да

amount

Сумма verify

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

да

currency

Валюта verify: UAH

да

card

Номер карты 16 цифр

да

expMonth

Месяц истечения срока действия карты - MM

да

expYear

Год истечения срока действия карты - YY

да

cardCvv

Секретный корд карты CVV/CVV2

да

cardHolder

Имя владельца карты, как указано на карте

да

clientEmail

Email клиента

нет

clientPhone

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

нет

clientCountry

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

нет

clientAddress

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

нет

clientCity

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

нет

clientState

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

нет

clientZipCode

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

нет

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

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

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

 

Параметр

Описание

Пример

merchantAccount

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

test_merchant

orderReference

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

1212dd1

merchantSignature

hash_hmac

 

amount

Сумма verify

100

currency

Валюта verify

UAH

authCode

код авторизации - присваивается банком

324567

createdDate

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

123456789

processingDate

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

12345678

cardPan

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

42****4242

cardType

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

Visa

issuerBankCountry

Страна карты

980

issuerBankName

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

PrivatBank

recToken

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

121213321-3213213-3213213-321-3

transactionStatus

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

Approved

reason

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

Ok

reasonCode

Код отказа

1100

fee

Комиссия psp

0.00

paymentSystem

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

card

Пример запроса и ответа

Запрос:
Ответ (запрос на serviceUrl)

Пример корректного ответа от мерчанта

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

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

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

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

Для авторизованных и проверенных заказов (а также при смене статуса заказа) серевер WayForPay направляет на serviceUrl запрос (HTTP_POST) включающий в себя данные заказа.

Данная информация дополняется контрольной подписью HMAC_MD5.


 

  • Нет меток