Данное 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
}
