Основні поняття

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

Поняття	Значення
Обліковий запис	Користувач, який входить на платформу й отримує доступ до мерчантів і магазинів.
Мерчант	Бізнес в Invoise з власними магазинами, командою та умовами.
Магазин	Місце, де створюються рахунки й депозити. Має власні налаштування отримувача, API-ключі та історію операцій.
Рахунок	Запит на одноразову оплату фіксованої суми. Створюється через /invoices.
Депозит	Багаторазова адреса для поповнень без фіксованої суми. Створюється через /deposits.
Вхідний переказ	Кошти, надіслані платником на адресу рахунку або депозиту. Один рахунок можуть оплатити кілька переказів.
Виплата	Отримані кошти, переказані отримувачу магазину за вирахуванням комісії сервісу.

issuance — назва ресурсу API, спільна для рахунків і депозитів. Збережіть id з відповіді про створення як issuance_id для подальших запитів.

Пов’яжіть замовлення у своїй системі з рахунком через external_id. Сутність в Invoise завжди рахунок.

Як працює платіж

1. Створіть рахунок або депозит.
2. Дочекайтеся його address, потім передайте клієнту отриманий payment_url.
3. Клієнт надсилає обраний токен в обраній мережі.
4. Invoise підтверджує вхідний переказ. Щойно коштів достатньо, вона надсилає виплату вашому отримувачу.

Прогрес можна перевірити GET-запитом або отримувати вебхуки. Див. Статус рахунку та депозиту.

Рахунок стає funded, коли надійшло достатньо підтверджених коштів. Завершення виплати підтверджується окремо подією payout.confirmed.

Куди йдуть виплати

Налаштування	Призначення
Адреса отримувача	Гаманець, що отримує виплати в EVM. Перевірте, що він підтримує обрані вами мережі.
Гаманець Invoise	Замість адреси магазин може платити у гаманець Invoise учасника облікового запису.
Делегат	Опціональний гаманець під вашим контролем, який може самостійно закривати EVM-рахунки й оплачувати газ. Адреса біржі для цього не підходить.

Отримувача, делегата та вибір між адресою і гаманцем Invoise можна змінити пізніше через PATCH /shops/{shop_id}. Кожен рахунок і депозит зберігає отримувача й делегата, з якими його створили, тож зміна стосується лише рахунків і адрес, створених після неї.

У Solana і Tron свої власні отримувачі. Див. Solana і Tron.

Комісії та невеликі платежі

Комісія сервісу віднімається з виплати. Перевіряйте актуальні комісії та ліміти свого магазину; не розраховуйте їх за скопійованим прайс-листом.

Для депозитів невеликі платежі накопичуються, поки не буде досягнуто порогу виплати. Для рахунків часткові платежі накопичуються, поки не буде досягнуто суми рахунку. Переплата за рахунком іде в Invoise разом з комісією, а не вашому отримувачу.

Скористайтеся магазином-пісочницею, щоб спробувати інтеграцію без реальних коштів.