Запрос Check Status используется для проверки статуса платежа по orderReference .
Запрос формируется на стороне торговца и передается методом POST на URL https://api.wayforpay.com/api
Необходимо создать json строку и отправить её curl-ом на наш сервер.
Параметры запроса:
Параметр | Описание | Обязательное |
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
}