Оформлення криптоплатежу надійне лише тоді, коли серверна частина мерчанта розуміє статус платежу. Клієнт може сплатити точну суму, недоплатити, переплатити, переказати кошти після завершення строку дії або спричинити перевірку ризиків.
Для мерчантів ці статуси — не декоративні позначки. Саме вони визначають, чи потрібно виконати замовлення, призупинити його, зарахувати кошти, повернути платіж або передати випадок на розгляд службі підтримки.
Чому статуси інвойсів важливі
З погляду мережі блокчейн-платежі остаточні, але замовлення мерчанта все одно потребують бізнес-логіки. Система оформлення покупки має зіставити транзакцію із замовленням і визначити наступну дію.
Статус платежу дає серверній частині стабільне правило й усуває потребу вручну перевіряти кожну транзакцію.
Оплачені інвойси
Статус інвойсу «оплачено» означає, що клієнт надіслав очікуваний платіж, і мерчант може продовжити виконання замовлення відповідно до своєї політики. Для цифрових продуктів це може відкрити доступ до вмісту. В інтернет-магазині замовлення може перейти до обробки.
Використовуйте вебхуки, щоб замовлення оновлювалося автоматично, коли інвойс отримує статус «оплачено».
Недоплачені інвойси
Статус інвойсу «недоплачено» означає, що отримана сума менша за очікувану. Причиною можуть бути комісії гаманця, плутанина з обмінним курсом, помилка під час ручного введення або неправильне розуміння з боку клієнта.
Мерчантам слід заздалегідь вирішити, чи просити доплату, дозволяти невелике відхилення, залишати замовлення в очікуванні або скасовувати його. Правильна політика залежить від маржинальності продукту та очікуваного рівня підтримки.
Переплачені інвойси
Статус інвойсу «переплачено» означає, що клієнт надіслав більше, ніж потрібно. Це може бути нешкідливо, але мерчанту все одно потрібен чіткий порядок обліку. Поширені варіанти — внутрішнє зарахування, ручне повернення, бонусний кредит або перевірка службою підтримки.
Найважливіше — видимість ситуації. Якщо серверна частина знає, що інвойс має статус «переплачено», оператори можуть послідовно врегулювати випадок.
Прострочені та пізні платежі
Інвойси часто мають строк дії, щоб мерчант не був назавжди прив’язаний до старого курсу або сеансу оформлення покупки. Клієнт усе одно може надіслати кошти після завершення цього строку, тому пізні платежі потребують чіткої обробки.
Не обробляйте пізні платежі як звичайні оплачені замовлення, якщо це не передбачено вашою політикою. Відокремлюйте їх, щоб служба підтримки та бухгалтерія могли визначити наступний крок.
Звірка за вебхуками
Найбезпечніший підхід до інтеграції — звірка насамперед за вебхуками. Створіть інвойс, покажіть платіжні реквізити, а потім оновлюйте замовлення лише після того, як серверна частина отримає та перевірить подію зі статусом платежу.
Почніть з API криптоінвойсів і підключіть його до автомата станів замовлення до запуску оплати в продакшені.
