API Получения Списка транзакций

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