Дане 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 | Міжнародний банківський номер рахунку | так |
| 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 |
| 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",
"iban":"UA261234560000026000000000000",
"okpo":"123456789",
"accountName":"ФОП Iванов Iван Iванович",
"description":"Спалата рахунку №2"
}
{
"merchantAccount": "p2p_account",
"orderReference": "myOrder1",
"merchantSignature":"b95932786cbe243a76b014846b63fe92",
"amount": 10.13,
"currency": "UAH",
"createdDate": 1415379863,
"processingDate": 1415379863,
"transactionStatus": "Approved",
"reason": "Ok",
"reasonCode": 1100
}
