Данное API позволяет производить пополнения расчетных счетов Юр. лиц и ФОП с банковского счета ТСП.
Пополнение возможно расчетных счетов, открытых в любом Украинском Банке.
Параметры запроса
Запрос c необходимыми параметрами формируется на стороне торговца и передается методом POST по протоколу HTTP на URL https://api.wayforpay.com/api
В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца.
Строка, подлежащая HMAC_MD5, генерируется путем конкатенации merchantAccount, orderReference, amount, currency,iban, okpo, accountName
разделенных “;” (точка с запятой) в кодировке UTF-8
Параметр | Описание | Обязательное |
transactionType | Тип запроса, принимает значение P2P_ACCOUNT | да |
merchantAccount | Уникальный идентификатор продавца. | да |
merchantAuthType | Тип авторизации: simpleSignature (по умолчанию) | нет |
orderReference | Уникальный номер заказа в системе торговца | да |
amount | Сумма перевода | да |
currency | Валюта перевода: UAH | да |
iban | iban счета | да |
okpo | ОКПО/ИНН получателя | да |
accountName | Название юр. лица/счета | да |
merchantSignature | Подпись заказа | да |
apiVersion | Версия протокола.Значение по-умолчанию: 1 | да |
description | Назначение платежа. С этим назначением средства будут отправлены на счет | нет |
serviceUrl | URL, на который система должна отправлять ответ с результатом пополнения напрямую мерчанту | нет |
recipientLastName | Фамилия получателя | нет |
recipientPhone | Телефон получателя | нет |
recipientEmail | E-mail Получателя | нет |
Параметры ответа
В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца.
Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров 'merchantAccount', 'orderReference', 'amount', 'currency', 'transactionStatus', 'reasonCode'
разделенных “;” (точка с запятой) в кодировке UTF-8
Параметр | Описание | Пример |
merchantAccount | Идентификатор продавца | test_merchant_n1 |
orderReference | Уникальный номер заказа в системе торговца | 1212dd1 |
merchantSignature | hash_hmac | |
amount | Сумма заказа | 100 |
currency | Валюта заказа | UAH |
account | Номер счета | 2600002320 |
mfo | МФО Банка | 123456 |
okpo | ОКПО/ИНН получателя | 123456789 |
accountName | Название юр. лица/счета | PrivatBank |
description | дата создания запроса в psp (UTC) | 123456789 |
processingDate | дата процессирования транзакции (UTC) | 12345678 |
transactionStatus | статус транзакции | Approved |
reason | Причина отказа | Ok |
reasonCode | Код отказа | 1100 |
Пример запроса и ответа
{
"transactionType":"P2P_ACCOUNT",
"merchantAccount":"p2p_account",
"merchantAuthType":"simpleSignature",
"merchantSignature":"60c5d743b71f79abe48c7183ada4b451",
"apiVersion":1,
"orderReference":"myOrder1",
"amount":10.13,
"currency":"UAH",
"account":"26000000000000",
"mfo":"123456",
"okpo":"123456789",
"accountName":"ФОП Иванов Иван Иванович",
"description":"Оплата счета №2"
}
{
"merchantAccount": "p2p_account",
"orderReference": "myOrder1",
"merchantSignature":"b95932786cbe243a76b014846b63fe92",
"amount": 10.13,
"currency": "UAH",
"createdDate": 1415379863,
"processingDate": 1415379863,
"transactionStatus": "Approved",
"reason": "ok",
"reasonCode": 1100
}