Перейти до основного вмісту

Операції з приймання коштів для подальшого їх переказу

Запит

URI: /api/v2/currency-exchange/transfer-money

Метод дозволяє виконувати операції з приймання коштів для подальшого їх переказу.

Запит виконується методом POST з тілом запиту у JSON форматі.

⚠️ Запит повинен містити заголовки Accept: application/json та Content-Type: application/json

Параметри запиту

Ім'яТипОбов'язковийОпис
api_tokenstringТакУнікальний токен для авторизації запиту
num_fiscalintegerТакФіскальний номер операції
action_typestringТакТип дії: CURRENCY_SEND_MONEY — переказ коштів
local_numberstringТакЛокальний номер операції, який клієнт передає з кожним чеком
from_namestringТакРеквізити платника переказу.
🛈Дозволяється друкувати: необхідну ідентифікаційну інформацію (прізвище, ім’я, по батькові (за наявності), номер договору, реєстраційний код тощо)
from_edrpoustringНіКод ЄДРПОУ або інший ідентифікатор відправника
to_namestringТакРеквізити отримувача переказу.
🛈Дозволяється друкувати: необхідну ідентифікаційну інформацію (найменування або прізвище, ім’я, по батькові (за наявності), податковий номер або серію (за наявності) та номер паспорта)
to_edrpoustringНіКод ЄДРПОУ або інший ідентифікатор отримувача (серію (за наявності) та номер паспорта)
bank_namestringТакНазва банку отримувача
ibanstringТакМіжнародний номер банківського рахунку (IBAN) отримувача, відкритого у банку
payment_idstringТакУнікальний ідентифікатор платежу
sumnumberТакСума переказу без комісії
total_sumnumberТакЗагальна сума до сплати, що включає основну суму та комісію
commissionnumberТакСума комісії за операцію
paymentobjectТакОб'єкт, що містить деталі оплати
payment.namestringТакНазва форми оплати:
  • ГОТІВКА
  • БЕЗГОТІВКОВА
  • ІНШЕ
payment.sumnumberТакСума оплати
no_text_printbooleanНіПараметр для відключення друку текстового чека
no_pdfbooleanНіПараметр для відключення генерації PDF-версії чека
no_qrbooleanНіПараметр для відключення генерації PDF-версії чека

Приклад запиту

Запит: /api/v2/currency-exchange/transfer-money

{
"api_token": "{{api_token}}",
"num_fiscal": {{num_fiscal}},
"action_type": "CURRENCY_SEND_MONEY",
"local_number": "4",
"from_name": "Petrovich",
"from_edrpou": "EB121212",
"to_name": "Evgeniy",
"to_edrpou": "EH303030",
"bank_name": "MONO",
"iban": "UA124215125213581277812241",
"payment_id": "7777777",
"sum": 100.0,
"total_sum": 101.0,
"commission": 1,
"payment": {
"name": "Готівка",
"sum": 101.0
},
"no_text_print": true,
"no_pdf": true,
"no_qr": true
}

Параметри відповіді

Ім'яТипОпис
ORDERNUMstringФіскальний номер чека
ORDERDATEstringДата формування чека у форматі YYYY-MM-DD
ORDERTIMEstringЧас формування чека у форматі HH:MM:SS
MACstringКод автентифікації повідомлення чека
is_offlinebooleanПараметр, що вказує, чи було замовлення створено в офлайн-режимі
qrstringQR-код (або посилання на нього)
qr_datastringДані для генерації QR кода
linkstringПосилання для перегляду чека на сайті
pdfstringПосилання на PDF-версію чека
text_printstringТекстова версія чека для друку
uuidstringІдентифікатор чека
local_numberstringЛокальний номер операції, який клієнт передає з кожним чеком
cash_in_boxintegerСума готівки в касі після операції

Приклад успішної відповіді

200 OK

Відповідь: /api/v2/currency-exchange/transfer-money
{
{
"ORDERNUM": "DEV_689f16f35b8cf",
"ORDERDATE": "2025-08-15",
"ORDERTIME": "14:16:02",
"MAC": "3317dca7b3323c0ed0fbb4a1471cacb22d8013641e5149e5a0fa77b981e03a7a",
"is_offline": false,
"qr": null,
"qr_data": null,
"link": null,
"pdf": null,
"text_print": null,
"uuid": "388b748e-22cb-45b8-a423-7b47a0ce6daa",
"local_number": "4",
"cash_in_box": 0
}
}