Запрос 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
}
