Проверка статуса платежа (Check Status)

Запрос Check Status используется для проверки статуса платежа по orderReference . 

Запрос формируется на стороне торговца и передается методом   POST на URL https://api.wayforpay.com/api

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

 

Параметр

Описание

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

transactionType

Тип запроса, принимает значение CHECK_STATUS

да

merchantAccount

Уникальный идентификатор продавца.

да

orderReference

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

да

merchantSignature

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

да

apiVersion

Версия протокола.

Значение по-умолчанию: 1

Значение 2 - включают передачу расширенных данных в ответе - доп поля, доставка, комментарии.

да

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

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

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

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

 

Параметр

Описание

Пример

merchantAccount

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

test_merch_n1

orderReference

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

1212dd1

merchantSignature

hash_hmac

 

аmount

Сумма заказа

100

currency

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

 

32456

UAH

authCode

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

324567

createdDate

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

123456789

processingDate

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

12345678

cardPan

Маскированный номер карты

42****4242

cardType

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

Visa

issuerBankCountry

Страна карты

980

issuerBankName

Имя Банка Банка эмитента карты

PrivatBank

transactionStatus

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

Approved

reason

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

Ok

reasonCode

Код отказа

1100

settlementDate

Дата возмещения транзакции мерчанту

123456789

settlementAmount

Сумма возмещения

98.50

fee

Комиссия psp

1.50

refundAmount

Сумма всех возвращенных средств

2.3

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

Запрос:
{
"transactionType":"CHECK_STATUS",
"merchantAccount": "test_merch_n1",
"orderReference": "DH783023",
"merchantSignature": "b95932786cbe243a76b014846b63fe92",
"apiVersion": 1
}
Ответ:
{
"merchantAccount": "test_merch_n1",
"orderReference": "DH783023",
"merchantSignature":"b95932786cbe243a76b014846b63fe92",
"amount": "100",
"currency": "UAH",
"authCode": "221562",
"createdDate": 123456789,
"processingDate": 123456789,
"cardPan": "44****1212",
"cardType": "Visa",
"issuerBankCountry": "UA",
"issuerBankName": "PrivatBank",
"transactionStatus": "Approved",
"reason": "ok",
"reasonCode": "1100",
"settlementDate": "123456789",
"settlementAmount": 98.50,
"fee": 1.50
}