Запрос TRANSACTION LIST используется для получения списка транзакций по магазину за определенный период времени.
Запрос формируется на стороне торговца и передается методом POST на URL https://api.wayforpay.com/api
Параметры запроса:
Параметр | Описание | Обязательное |
transactionType | Тип запроса, принимает значение TRANSACTION_LIST | да |
merchantAccount | Уникальный идентификатор продавца. | да |
merchantSignature | Подпись запроса | да |
apiVersion | Версия протокола. Значение по-умолчанию: 1 Значение 2 - включают передачу расширенных данных в ответе - доп поля, доставка, комментарии. | да |
dateBegin | Дата начала периода, timestamp | да |
dateEnd | Дата завершения периода, timestamp | да |
В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца.
Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров merchantAccount;dateBegin;dateEnd разделенных “;” (точка с запятой) в кодировке UTF-8
Параметры ответа:
Параметр | Описание | Пример |
reason | Результат ответа | Ок |
reasonCode | Код ответа | 1100 |
transactionList | Список транзакций запрашиваемый период | |
transactionType | Тип транзакции | Purchase |
orderReference | Уникальный номер заказа в системе торговца | 1212dd1 |
createdDate | Дата создания запроса в psp | 123456789 |
amount | Сумма заказа | 100 |
currency | Валюта заказа | UAH |
transactionStatus | Статус транзакции | Approved |
processingDate | Дата процессирования транзакции | 12345678 |
reasonCode | Причина отказа | 1100 |
reason | Код отказа | Ok |
| Email клиента | email@email.com |
phone | Номер телефона клиента | 380987654321 |
paymentSystem | Платежный метод, которым была проведена оплата | card |
cardPan | Маскированный номер карты | 42****4242 |
cardType | Типа карты: Visa/MasterCard | Visa |
issuerBankCountry | Страна карты | 980 |
issuerBankName | Имя Банка Банка эмитента карты | PrivatBank |
fee | Комиссия psp | 1.50 |
Пример запроса и ответа
{
"apiVersion": 1,
"transactionType": "TRANSACTION_LIST",
"merchantAccount": "test_merch_n1",
"merchantSignature": "b9277c081b29841e5eccea03d223e23a",
"dateBegin": 1454277600,
"dateEnd": 1454364000
}
{
"reason": "Ok",
"reasonCode": 1100,
"transactionList": [
{
"transactionType": "PURCHASE",
"orderReference": "RF3656-1454331982",
"createdDate": "1454332003",
"amount": "0.17",
"currency": "UAH",
"transactionStatus": "Declined",
"processingDate": "1454332238",
"reasonCode": "1101",
"reason": "Declined To Card Issuer",
"email": "dev@wayforpay.com",
"phone": "380660000001",
"paymentSystem": "card",
"cardPan": "41****1111",
"cardType": "Visa",
"issuerBankCountry": "",
"issuerBankName": "",
"fee": "0"
},
{
"transactionType": "PURCHASE",
"orderReference": "RF3656-1454338652",
"createdDate": "1454338658",
"amount": "0.17",
"currency": "UAH",
"transactionStatus": "InProcessing",
"processingDate": "1454338666",
"reasonCode": "1131",
"reason": "Transaction in processing",
"email": "dev@wayforpay.com",
"phone": "380660000001",
"paymentSystem": "privat24",
"cardPan": "",
"cardType": "",
"issuerBankCountry": "",
"issuerBankName": "",
"fee": "0"
}
]
}