Переказ коштів на розрахунковий рахунок (Account2account)

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