Ваша команда має відповіді на ключові питання. Ви близькі до запуску: проведіть свої тести з реальними платежами перед запуском.
Майже готові
Залишилося кілька прогалин. Закрийте їх перед запуском: кожна з них розглядається в розділі цієї статті.
Ще не готові
Декілька ключових рішень ще відкриті. Hosted Checkout забирає найбільше роботи з вашої команди, і ви можете запросити живу демонстрацію від команди продажів Volet.com, щоб спочатку побачити процес платежу.
Контрольний список перед запуском API
Дев'ять питань, на які потрібно відповісти перед запуском. Виберіть відповідь, яка підходить вашій команді: кожна відповідь відкриває коротку записку та вказує на частину цієї статті, яка це пояснює.
Питання 1 з 9
1. Чи потребує продукт власного інтерфейсу платежів?
Так, нам потрібен свій інтерфейс
Ні, підходить хостингова сторінка
Ще не вирішено
Якщо так, вам потрібен тільки API, і ваша команда створює та підтримує екрани платежів. Якщо ні, Hosted Checkout є менш трудомістким шляхом, і він також приймає платежі з балансів рахунків Volet.com.
→ Дивіться: API або Hosted Checkout: практичне порівняння, нижче
2. Чи повинні ми контролювати кожен етап платіжної воронки, чи прийнятний редирект?
Ми повинні контролювати кожен етап
Редирект підходить
Ще не вирішено
З редиректом на Hosted Checkout Volet.com надсилає сповіщення про статус на вашу URL-адресу статусу. З вашим власним інтерфейсом платежів на API ваш бекенд повинен самостійно перевіряти статус платежу.
→ Дивіться: API або Hosted Checkout: практичне порівняння, нижче
3. Чи маємо ми можливість створити та підтримувати інтерфейс платежів, обробку термінів дії та перевірки статусу?
Так, у нас є можливість
Ні, Hosted Checkout підходить нам краще
Ще не впевнені
Тільки API означає, що ваша команда володіє екранами платежів, термінами дії рахунків (ставка рахунку дійсна протягом 60 або 15 хвилин) та регулярними перевірками статусу.
→ Дивіться: Що насправді потрібно побудувати вашій команді, нижче
4. Чи визначили ми, як внутрішні замовлення відображаються на спробах платежів і як буде запобігатися дублюванню виконання?
Так, це визначено
Ще ні
Тримайте кожне замовлення окремо від його спроб платежів, використовуйте унікальний orderId для кожної спроби та виконуйте кожне замовлення лише один раз.
→ Дивіться: Модель замовлення та платежу на бекенді, нижче
5. Чи вирішили ми, як узгоджувати транзакції постачальників, отримані суми, збори та валюту розрахунків?
Так, у нас є процес
Ще ні
Зберігайте ідентифікатор транзакції Volet.com, отриману суму та валюту розрахунків з кожним замовленням, щоб кожен платіж відповідав рахунку.
→ Дивіться: Модель замовлення та платежу на бекенді, нижче
6. Чи запланували ми бюджет для сценаріїв невдач, повного контролю якості та моніторингу виробництва?
Так, це в плані
Ще ні
Оцінюйте щасливий шлях і шляхи невдач окремо: тайм-аути, прострочені рахунки та повторні спроби займають реальний інженерний час.
→ Дивіться: Оцінюйте роботу реалістично, нижче
7. Чи вирішили ми, як обробляти недоплату, переплату, запізнілі платежі та платежі через неправильну мережу?
Так, наші правила встановлені
Ще ні
Налаштування шлюзу вирішують, чи приймаються недоплати та переплати. Платежі, надіслані через неправильну мережу, можуть бути втрачені. Запишіть свої правила та політику повернення у своїх умовах продажу.
→ Дивіться: Як крипто-платежі відрізняються від карткових платежів, нижче
8. Чи знає фінансовий відділ, в якій валюті здійснюються платежі та як оцінюється конверсія?
Так, фінансовий відділ знає
Ще ні
Ви можете зберігати криптовалюту, яку отримуєте, або автоматично конвертувати її. USD, USDT та USDC конвертуються за фіксованим курсом 1:1; інші конверсії коштують додатково.
→ Дивіться: Скільки це коштує з Volet.com, нижче
9. Чи запланували ми, як тестувати з реальними платежами, враховуючи, що немає пісочниці?
Так, у нас є план тестування
Ще ні
Volet.com не має пісочниці. Запросіть живу демонстрацію, створіть шлюз заздалегідь і тестуйте з реальними платежами перед запуском.
→ Дивіться: Тестування без пісочниці, нижче
Ваш результат
Відповідайте на всі дев'ять питань, щоб побачити свій результат.
Ще відкриті:
Як крипто-платежі відрізняються від карткових платежів
Якщо ваша команда раніше інтегрувала карткові платежі, деякі звички не збережуться. З картками продавець стягує плату з покупця. З крипто-платежами покупець надсилає кошти зі свого гаманця, і ваша система повинна реагувати на те, що насправді надходить. Це змінює те, що повинна обробляти інтеграція.
Сума може відрізнятися від рахунку. Покупець може надіслати трохи менше або більше, ніж запитувалося, наприклад, через мережеві збори або різницю в курсах обміну. Вирішіть заздалегідь, чи приймати недоплату та переплату.
Наприклад, ви можете приймати невеликі різниці, зв'язатися з покупцем або видати повернення. Що б ви не вирішили, вкажіть це у ваших умовах продажу разом з вашими правилами повернення та тим, хто сплачує мережевий збір за повернення.
Мережа має значення. Один і той же токен існує на кількох блокчейнах. Кошти, надіслані через неправильну мережу або на неправильну адресу, можуть бути втрачені.
Цитата закінчується. Тариф рахунку дійсний протягом 60 хвилин, якщо ви розраховуєтеся в одній валюті, і протягом 15 хвилин, якщо потрібен обмін. Покупець, який платить пізно, може потребувати нового запиту на оплату.
Підтвердження займає час. Кошти зараховуються лише після того, як блокчейн підтвердить платіж, тому ваш інтерфейс і логіка замовлення повинні обробляти очікування.
Не існує повернень і автоматичних скасувань. Підтверджена транзакція в блокчейні не може бути скасована. Повернення є окремим платежем відповідно до вашої політики та застосовних правил захисту споживачів.
Розрахунок є бізнес-рішенням. Кошти зараховуються на ваш рахунок Volet.com після завершення платежу. Ви можете зберегти отриману криптовалюту або автоматично конвертувати її в стейблкоїни або фіат, щоб фінанси могли узгодити в одній валюті та уникнути волатильності.
Підтвердження мережі обробляються за вас. Volet.com моніторить блокчейн, чекає на необхідні підтвердження та зараховує кошти, тому ваш бекенд не повинен відстежувати блоки або кількість підтверджень.
Один баланс стейблкоїна через мережі. Стейблкоїн, отриманий в одній мережі, можна зняти через іншу підтримувану мережу без окремої послуги крос-ланцюгового мосту.
Без обігового резерву. Volet.com не утримує частину ваших завершених платежів як обіговий резерв.
Ваші правила для недоплат і переплат. У налаштуваннях шлюзу ви вирішуєте, чи приймати платежі, які менші або більші за суму рахунку. Наприклад, якщо клієнти поповнюють баланс у вас, ви можете зарахувати точно те, що надійшло, і приймати недоплати. У разі переплати лише сума замовлення зараховується на ваш рахунок.
Обробка запізнілих платежів. Якщо платіж надходить після закінчення терміну дії рахунку, Volet.com або повертає його клієнту, або, в деяких випадках, зараховує його на ваш рахунок.
Гроші на вході, гроші на виході. Той самий баланс Volet.com може фінансувати ваші вихідні платежі: масові виплати підрядникам, творцям або партнерам, або зняття для ваших власних користувачів. Наприклад, біржа може приймати крипто-депозити користувачів і обробляти їх крипто-виплати з того самого балансу Volet.com через API.
Volet.com допоможе побудувати глобальні платежі
У фіаті, криптовалюті та стейблкоїнах. Через API, Hosted Checkout або плагіни, які легко встановити. Приймайте, надсилайте кошти й керуйте ними — просто з коду.
Ключове рішення полягає в тому, скільки з досвіду оплати ваш продукт має контролювати — і скільки інженерних зусиль ви готові вкласти в це.
Виберіть лише API, коли вам потрібен власний інтерфейс оплати та контроль над усім процесом оплати. Ваш додаток контролює кожен етап, з яким стикається клієнт, від показу інструкцій з оплати до інформування клієнта, поки платіж не буде підтверджено або не закінчиться. Ваша команда створює та підтримує все це.
Виберіть Hosted Checkout, коли налаштований інтерфейс оплати та повний контроль над кожним етапом не є вимогами. Volet.com хостить платіжну сторінку, що робить цей шлях зазвичай простішим і менш трудомістким. Він також працює всередині ботів Telegram та міні-додатків, де платіжна сторінка відкривається у вікні браузера в додатку (webview).
Ось як може виглядати Hosted Checkout від Volet.com
Ви також можете поєднати Hosted Checkout з API для перегляду замовлень та звірки. У будь-якому випадку, Hosted Checkout все ще потребує роботи на бекенді. Ваш додаток зберігає власні записи замовлень і співвідносить їх зі статусом платежу на стороні Volet.com. Ваш бекенд також підписує запити, які він надсилає до Hosted Checkout, що допомагає захистити від підроблених запитів, які можуть перенаправити платіж клієнта з вашого магазину.
Фактор прийняття рішення
Тільки API
Hosted Checkout
Інтерфейс платежів для клієнтів
Створено та підтримується вашою командою
Хоститься Volet.com
Контроль над платіжною воронкою
Високий: ваш додаток володіє досвідом
Більш обмежений: клієнт слідує за хостингом
Зусилля інженерів
Вищі: UI, перевірки статусу, терміни дії та крайні випадки
Нижчі для інтерфейсу платежів; бекенд все ще підписує запити на платежі, обробляє сповіщення та оновлює замовлення
Найкраще підходить
Кастомізований процес оформлення замовлення на веб-сайті або в додатку, боті чи платформі
Стандартний платіжний процес, де перенаправлення на хостингову сторінку є прийнятним, включаючи Telegram-ботів та міні-додатки
Обробка статусу
Бекенд перевіряє статус платежу через API
Сповіщення про статус URL плюс запит API для звірки за потреби
Платіж з балансу рахунку Volet.com
Недоступно: тільки API приймає криптовалюту з зовнішніх гаманців
Доступно: клієнти можуть платити з балансу свого рахунку Volet.com, комісія 0.25%
У фіаті, криптовалюті та стейблкоїнах. Через API, Hosted Checkout або плагіни, які легко встановити. Приймайте, надсилайте кошти й керуйте ними — просто з коду.
Точки доступу до рахунків є лише частиною реалізації лише API. Перш ніж зобов'язатися, врахуйте продукт і операційні обов'язки нижче.
Як працює потік з API-only:
Створіть замовлення у своїй системі.
Створіть крипторахунок через API.
Покажіть клієнту адресу, суму, валюту, мережу та час закінчення, повернуті API.
Клієнт надсилає платіж зі свого гаманця.
Ваш бекенд перевіряє статус платежу через API.
Якщо платіж підтверджено, позначте замовлення як оплачене та виконайте його.
Як працює потік з Hosted Checkout та API:
Створіть замовлення у своїй системі та перенаправте клієнта на Hosted Checkout з вашим orderId.
Клієнт платить на сторінці Hosted Checkout.
Volet.com надсилає сповіщення на вашу Status URL, кінцеву точку на вашому сервері, яка отримує оновлення платежів.
Ваш бекенд перевіряє підпис і, якщо потрібно, підтверджує замовлення через API.
Позначте замовлення як оплачене та виконайте його.
Інтерфейс платежу та життєвий цикл рахунків. Ваш додаток повинен точно відображати деталі платежу, повернуті API: суму для надсилання, валюту, мережу блокчейну, адресу, будь-який тег призначення або примітку та час закінчення. Він повинен попереджати клієнтів надсилати кошти лише через вказану мережу. Неправильні інструкції щодо платежу можуть призвести до втрати коштів, тому це є функціональною вимогою, а не візуальною деталлю.
Не повідомляйте клієнта, що платіж не вдався або завершився, поки статус платежу не підтвердить це.
Модель замовлення та платежу на бекенді. Тримайте ваше внутрішнє замовлення окремо від спроби платежу або рахунка. Це полегшує обробку залишених кошиків, прострочених рахунків, повторних спроб клієнта та оновлень статусу, які надходять після того, як користувач залишив сторінку.
Використовуйте унікальний orderId для кожної спроби платежу, як описано в документації API. Визначте у своїй базі даних, як кожна спроба відповідає замовленню. Зберігайте ідентифікатор транзакції Volet.com, отриману суму та валюту розрахунку з кожним замовленням, щоб фінансовий відділ міг зіставити кожен платіж з рахунком без ручних таблиць. Податкова обробка крипто-квитанцій залежить від вашої юрисдикції, тому погодьте це зі своїм бухгалтером.
Виберіть модель суми рахунка. Вирішіть, чи замовлення оцінюється у валюті, яку ви очікуєте отримати, або чи повинен клієнт надіслати фіксовану суму конкретної криптовалюти. Цей вибір впливає на відображення ціни, звірку та те, як ви пояснюєте суму до сплати. Вирівняйте це з вашою моделлю ціноутворення та бухгалтерського обліку, і перевірте обчислені значення перед створенням живих рахунків. Документація API пояснює, як налаштувати кожен варіант.
Припустимо, ваш клієнт робить замовлення на €120 і платить криптовалютою. Ваш бекенд повинен зберігати достатньо інформації, щоб зв'язати завершений платіж з оригінальним замовленням. Для цього платежу він зберігатиме:
Ваш ідентифікатор замовлення (ORD-10482) ідентифікує покупку у вашій системі.
Ідентифікатор транзакції Volet.com (VLT-839201) пов'язує платіж з транзакцією на стороні Volet.com.
Сума, що надійшла (близько 139 USDT) показує, що насправді надіслав клієнт.
Валюта розрахунку (EUR) фіксує валюту, в якій обліковується ваша фінансова команда.
Статус платежу (остаточний, підтверджений API) повідомляє, чи може платіж вважатися завершеним.
Для вирівнювання зв'яжіть транзакцію Volet.com з вашою спробою платежу та замовленням, а потім порівняйте ідентифікатор транзакції, очікувані та отримані суми, валюту та остаточний статус платежу. Якщо платіж відсутній, запізнився або не відповідає очікуваній сумі, позначте його для розслідування замість автоматичного позначення замовлення як сплаченого.
Клієнт створює замовлення, відкриває сторінку оплати та надсилає необхідну криптовалюту. Перш ніж блокчейн підтвердить транзакцію, він закриває вкладку браузера та покидає ваш веб-сайт.
Ваш бекенд продовжує відстежувати платіж:
Замовлення клієнта залишається в очікуванні у вашій системі.
Спроба платежу триває незалежно. При використанні лише API ваш бекенд перевіряє його статус через API. При використанні Hosted Checkout Volet.com надсилає сповіщення на вашу URL-адресу статусу.
Ваш бекенд перевіряє статус платежу через API.
Як тільки платіж підтверджується як завершений, ваша система позначає замовлення як оплачено та ініціює виконання.
Якщо клієнт повертається на ваш веб-сайт, він бачить оновлений статус замовлення.
Важливий момент: закриття сторінки оформлення замовлення не скасовує платіж і не підтверджує його. Ваш бекенд, а не перенаправлення браузера, визначає, коли замовлення може бути виконано.
Обробка статусу та відновлення. З API-only ваша команда повинна вибрати стратегію опитування (як часто бекенд перевіряє статус), уникати непотрібних запитів і обробляти тимчасові збої запитів без неправильних змін стану замовлення.
Розглядайте сповіщення як сигнал, а не як доказ платежу: перевірте його підпис і знайдіть замовлення через API перед його виконанням. Обробляйте кожне замовлення один раз, використовуючи ваш власний orderId, щоб повторне сповіщення або друга перевірка статусу не могли виконати його двічі.
Виконуйте замовлення лише після того, як API підтвердить, що платіж завершено, а не коли створення рахунку успішне або браузер перенаправляє. Точні значення статусу та способи обробки кожного з них описані в документації API.
A request can time out even when the remote system has processed it. Do not blindly retry invoice creation after an ambiguous failure. Before deciding what to do next, log the API's errorId, check the existing order and payment state, and follow the documented error handling. Never create a duplicate order automatically, and retry a request only when it is safe to do so.
Безпека та готовність до роботи. Зберігайте секрети API та облікові дані аутентифікації на сервері. Ніколи не розкривайте їх у коді фронтенду, мобільних додатках, ботах або скриптах на стороні клієнта. Налаштуйте лише ті дозволи, які потрібні для інтеграції, і обмежте доступ до API лише для IP-адрес ваших серверів: дозволяти всі IP-адреси не рекомендується в продуктивному середовищі.
Проектування надійного платіжного потоку
Платіжний потік повинен обробляти більше, ніж просто успішний випадок.
Вирішіть, що продукт повинен робити, коли:
створення рахунку вичерпується, і результат невідомий;
тимчасово не вдається перевірити статус;
рахунок закінчується до того, як клієнт платить;
клієнт залишає оформлення замовлення і пізніше повертається;
клієнт починає ще одну спробу платежу;
сповіщення про статус затримується або отримується більше одного разу.
Мета полягає в тому, щоб уникнути дублювання виконання, зберігати внутрішній стан замовлення послідовним і надати клієнту чіткий наступний крок.
Volet.com не має пісочниці або тестового середовища. Заплануйте це заздалегідь, а не відкривайте це під час запуску:
Запросіть живу демонстрацію у команди продажів Volet.com, щоб побачити платіжний потік, API та Hosted Checkout перед тим, як ви почнете будувати.
Створіть шлюз заздалегідь. Новий кастодіальний шлюз (той, де Volet.com утримує отримані кошти на вашому рахунку) проходить перевірку на відповідність, яка зазвичай займає кілька годин, і ви можете закінчити інтеграцію в цей час.
Тестуйте з реальними платежами в продуктивному середовищі: успіх, невдача, закінчення терміну, недоплата та переплата. Кожен тестовий платіж у криптовалюті є реальною транзакцією в ланцюзі з комісією за мережу.
Для Hosted Checkout також перевірте доставку Status URL, валідацію підпису та перенаправлення на успіх і невдачу.
Позначте тестові замовлення у вашій базі даних, щоб вони не змішувалися з реальними доходами під час звірки.
Оцінка роботи реалістично
Фактичні зусилля залежать від вашої існуючої архітектури оформлення замовлення, необхідного користувацького досвіду, досвіду ваших інженерів з платіжними API та обсягу тестування (QA).
Робочий потік
Тільки API
Hosted Checkout
Налаштування облікового запису та шлюзу
Перевірка облікового запису, налаштування API, дозволи та затвердження
Перевірка облікового запису, налаштування Hosted Checkout та будь-яке необхідне затвердження
Основна реалізація
Створення рахунку, UI платежу, перевірки статусу та оновлення замовлення
Перенаправлення, обробка Status URL та оновлення замовлення на бекенді
Країні випадки
Термін дії, неоднозначні тайм-аути, повторні спроби, дублюючі спроби та інструкції мережі
Валідація сповіщень, крайні випадки перенаправлення та узгодження
QA
Відображення деталей платежу, перевірки статусу, терміни дії, збої та відновлення
Перенаправлення, доставка сповіщень, валідація підписів та узгодження
Постійна власність
Обслуговування UI, моніторинг, діагностика підтримки та обробка статусів
Моніторинг бекенду, узгодження замовлень та операції зворотного виклику
Оцінити успішний шлях та шляхи невдач окремо, і включити час для тестування від початку до кінця та моніторингу виробництва.
Скільки це коштує з Volet.com
Від 0,25% за платежі у стейблкоїнах та криптовалюті. Конверсії між USD, USDT та USDC проходять за фіксованим курсом 1:1; інші конверсії оцінюються окремо. Клієнт сплачує комісію за мережу блокчейн. Немає плати за налаштування та щомісячної плати. Ви обираєте, хто сплачує комісію за обробку. Великі обсяги можуть відповідати умовам для індивідуального ціноутворення через продажі.
Приймайте USDT, USDC і провідні криптотокени з усього світу
Почніть із криптоплатіжного шлюзу — миттєві зарахування та комісія від 0,25%
Ні. Volet.com не має тестового середовища. Ви можете запросити живу демонстрацію у команди продажів. Тестуйте успіх, невдачу, терміни, недоплату та переплату з вашого боку перед запуском.
Нові кастодіальні шлюзи спочатку проходять перевірку на відповідність. Це зазвичай займає кілька годин. Ваш обліковий запис повинен бути перевірений перед створенням шлюзу. Використовуйте час очікування, щоб завершити інтеграцію.
Ні. З API-only ваш бекенд самостійно перевіряє статус платежу. Якщо вам потрібні сповіщення, використовуйте Hosted Checkout разом з API.
Налаштування вашого шлюзу визначають, чи приймаються недоплати та переплати. Якщо платіж надходить після закінчення терміну рахунку, Volet.com або повертає його клієнту, або, в деяких випадках, зараховує на ваш рахунок. Клієнт, який все ще хоче заплатити, може потребувати нового запиту на платіж.
Перевірте замовлення через API за вашим orderId перед тим, як відповісти.
Переклад може бути видимим в блокчейні і все ще не відповідати рахунку: він може бути коротким, запізнілим або надісланим через іншу мережу.
Надайте вашій команді підтримки доступ до деталей платежу та заздалегідь домовтеся, коли вони повинні ескалювати справу до підтримки Volet.com.
Ні. Підтверджена транзакція в блокчейні не може бути скасована, і немає повернень через мережу карт. Повернення є окремим платежем відповідно до вашої політики та застосовних правил захисту споживачів.
Ні. Volet.com не надає послуги з прийому карт. Залиште свого постачальника карт для прямих карткових платежів.