Дане API дозволяє робити поповнення розрахункових рахунків Юр. осіб та ФОП з банківського рахунку ТСП.
Поповнення можливо лише розрахункових рахунків, відкритих в будь-якому українському банку.
Параметри запиту
Запит з необхідними параметрами формується на стороні продавця та передається методом 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_hm{ "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" }ac | |
| 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
}
