Документація API сповіщень зворотного виклику Gate Pay: https://docs.gate.com/api-reference/version/100/en/common/asyncNotification
Як інтерпретувати інформацію про статус зворотного виклику платежу
Динамічний тип адреси
1. Сповіщення про надходження коштів на динамічну адресу (biztype = TRANSFER_ADDRESS)
TRANSFERRED_ADDRESS_IN_TERM: Кошти зараховуються миттєво протягом строку дії замовлення.
TRANSFERRED_ADDRESS_DELAY: Якщо платіж надійшов після завершення строку дії, фактично сплачена сума буде зарахована на баланс мерчанта (миттєве зарахування після завершення строку дії).
2. Сповіщення про зміну статусу замовлення з динамічною адресою (biztype = PAY_ADDRESS)
PAY_SUCCESS: Платіж успішний.
PAY_CLOSE: Термін дії замовлення закінчився.
PAY_EXPIRED_IN_PROCESS: Очікується підтвердження коштів у мережі.
Статичний тип адреси
1. Успішний платіж на статичну адресу (biztype=PAY_FIXED_ADDRESS)
PAY_SUCCESS: Платіж успішний, кошти зараховано.
2. Статична адреса позначена як ризикована (biztype=FIXED_ADDRESS_RISK)
RISK_ADDRESS: Статична адреса була позначена як ризикована.
Тип платежу на аномальну адресу
Для кожної аномальної транзакції Gate Pay надсилатиме webhook-сповіщення відповідному мерчанту.
bizType для цього типу платежу завжди PAY_UNRESOLVED.
Мерчанти мають визначити проблему з оплатою на основі поля errorType у даних та звернутися до Інструкції з обробки аномальних платежів Gate Pay або до свого менеджера Gate Pay.
- address_risk_address
— Динамічна адреса з високим ризиком - address_error_currency
— Невірна валюта для динамічної адреси - address_error_chain
— Невірна блокчейн-мережа для динамічної адреси - fix_error_currency
— Невірна валюта для статичної адреси - fix_error_chain
— Невірна блокчейн-мережа для статичної адреси - fix_risk_address
— Статична адреса з високим ризиком - fix_delete
— Статичну адресу видалено - fix_partial_delete
— Статичну адресу частково видалено
Про сповіщення зворотного виклику для платежів на динамічну адресу
Чому існує два типи сповіщень зворотного виклику про платіж?
- Сповіщення про надходження коштів (TRANSFER_ADDRESS): Сповіщення про фактично зараховану суму.
- Сповіщення про зміну статусу замовлення (PAY_ADDRESS): Сповіщення про зміну статусу замовлення.
Мерчанти повинні використовувати обидва типи інформації, щоб визначити, чи було замовлення успішним, для подальшої доставки або обробки неуспішних замовлень.
Коли надсилаються сповіщення зворотного виклику?
- Сповіщення про надходження коштів: Після підтвердження платежу в мережі кошти миттєво зараховуються мерчанту, і надсилається зворотний виклик.
- Сповіщення про зміну статусу замовлення: Викликається при зміні статусу замовлення.
Сценарії оплати на динамічну адресу та визначення статусу замовлення
1. Одноразова повна або переплата протягом строку дії
Опис: Якщо користувач сплачує повну або більшу суму протягом строку дії замовлення, після підтвердження в мережі надсилається зворотний виклик у реальному часі.
Статус замовлення: Спочатку система очікує підтвердження коштів у мережі та надсилає зворотний виклик з проміжним статусом: bizStatus — PAY_EXPIRED_IN_PROCESS. Після підтвердження в мережі замовлення вважається успішним, надсилається зворотний виклик зі статусом bizStatus — PAY_SUCCESS та зарахованою сумою у полі doneAmountOnChain.
Сповіщення про надходження коштів: bizStatus — TRANSFERRED_ADDRESS_IN_TERM, зарахована сума — transferAmount.
2. Недоплата протягом строку дії
Опис: Якщо користувач сплачує менше суми замовлення протягом строку дії, після підтвердження в мережі фактично сплачена сума зараховується мерчанту, і надсилається зворотний виклик про надходження коштів у реальному часі.
Статус замовлення: Протягом строку дії статус замовлення не змінюється, і зворотний виклик про статус не надсилається.
Сповіщення про надходження коштів: bizStatus — TRANSFERRED_ADDRESS_IN_TERM, зарахована сума — transferAmount.
3. Недоплата протягом строку дії, без доплати
Опис: Якщо користувач сплачує менше суми замовлення протягом строку дії та не доплачує протягом цього періоду.
Статус замовлення: Коли строк дії замовлення закінчується, надсилається зворотний виклик про статус замовлення. bizStatus — PAY_CLOSE, зарахована сума — doneAmountOnChain.
Сповіщення про надходження коштів: Зворотний виклик про надходження коштів вже був надісланий після платежу та не надсилатиметься повторно.
4. Недоплата протягом строку дії, з подальшою доплатою
4.1 Доплата протягом строку дії:
Після того, як користувач доплачує решту суми:
Статус замовлення: Система очікує підтвердження коштів у мережі та надсилає зворотний виклик з проміжним статусом: bizStatus — PAY_EXPIRED_IN_PROCESS.
Сповіщення про надходження коштів: Поки очікується підтвердження доплати у мережі, сповіщення про надходження коштів не надсилається.
Після підтвердження в мережі:
Статус замовлення: Як тільки кошти в мережі підтверджено і сума є достатньою, замовлення вважається успішним. bizStatus — PAY_SUCCESS, зарахована сума — doneAmountOnChain (сума всіх платежів).
Сповіщення про надходження коштів: bizStatus — TRANSFERRED_ADDRESS_IN_TERM, зарахована сума — transferAmount.
4.2 Доплата після завершення строку дії:
Статус замовлення: Оскільки повна сума не була сплачена протягом строку дії, коли строк дії закінчується, надсилається зворотний виклик про статус замовлення. bizStatus — PAY_CLOSE, зарахована сума — doneAmountOnChain.
Сповіщення про надходження коштів: Зворотний виклик про надходження коштів вже був надісланий після платежу та не надсилатиметься повторно.
Якщо користувач доплачує решту після завершення строку дії: надсилається зворотний виклик про надходження коштів зі статусом bizStatus — TRANSFERRED_ADDRESS_DELAY, зарахована сума — transferAmount. (У цьому випадку додатковий зворотний виклик про статус замовлення не надсилається, і фінальний зворотний виклик не містить поля doneAmountOnChain. Якщо користувач здійснює платіж кількома транзакціями, мерчант має підсумувати всі значення transferAmount із зворотних викликів, щоб підтвердити загальну зараховану суму.)
5. Прострочений платіж
Опис: Якщо користувач сплачує після завершення строку дії замовлення — частково, повністю або переплачує, кошти зараховуються в реальному часі після підтвердження в мережі.
Зміна статусу замовлення: Оскільки платіж не був здійснений під час строку дії, коли строк дії закінчується, надсилається зворотний виклик зі статусом bizStatus — PAY_CLOSE.
Надходження коштів: Сповіщення про надходження коштів не надсилається.
Платіж після завершення строку дії: Після завершення строку дії для кожного платежу надсилається сповіщення про надходження коштів зі статусом bizStatus — TRANSFERRED_ADDRESS_DELAY, зарахована сума — transferAmount. (У цьому випадку додатковий зворотний виклик про статус замовлення не надсилається, і фінальний зворотний виклик не містить поля doneAmountOnChain. Якщо користувач здійснює платіж кількома транзакціями, мерчант має підсумувати всі значення transferAmount із зворотних викликів, щоб підтвердити загальну зараховану суму.)
Мерчанти повинні використовувати як інформацію про статус замовлення, так і про надходження коштів, щоб визначити, чи було замовлення успішним.
6. Інформація про аномальні зворотні виклики для платежів на динамічну адресу
6.1 Платіж у валюті або мережі, відмінній від зазначеної у замовленні
Мерчант отримає зворотний виклик з Biztype=PAY_UNRESOLVED і data.errorType=address_error_currency або address_error_chain.
6.2 Кошти позначені як ризикові та заблоковані
Мерчант отримає зворотний виклик з biztype=PAY_UNRESOLVED і data.errorType=address_risk_address.
Про сповіщення зворотного виклику для статичних адрес
1. Успішне зарахування платежу
Буде отримано сповіщення PAY_SUCCESS, що означає успішний платіж і зарахування коштів.
2. Зворотний виклик про аномальний платіж
2.1 Платіж у валюті/мережі, відмінній від зазначеної у замовленні
Мерчант отримає зворотний виклик з biztype=PAY_UNRESOLVED і data.errorType=fix_error_currency або fix_error_chain.
2.2 Ризикові кошти
Мерчант отримає зворотний виклик з biztype=PAY_UNRESOLVED і data.errorType=fix_risk_address.
2.3 Платіж на видалену статичну адресу
Мерчант отримає зворотний виклик з biztype=PAY_UNRESOLVED і data.errorType=fix_delete або fix_partial_delete.
3. Сповіщення про ризик статичної адреси
Буде отримано сповіщення з bizType=FIXED_ADDRESS_RISK і bizStatus=RISK_ADDRESS, що означає, що статична адреса отримання, прив'язана до мерчанта, була ідентифікована як ризикована. Мерчанти повинні негайно видалити відповідну статичну адресу. Якщо користувачі продовжують здійснювати платежі на цю адресу, кошти не будуть зараховані.
Відмова від відповідальності
Наданий тут зміст призначений лише для ознайомлення та освітніх цілей і не є фінансовою, інвестиційною, торговою чи юридичною порадою, а також не є пропозицією або закликом купувати чи продавати будь-які цифрові активи. Gate не надає жодних прямих чи непрямих заяв або гарантій щодо точності, повноти чи актуальності інформації, що міститься тут. Функціонал продукту, інтерфейси, правила та структура комісій можуть оновлюватися або змінюватися у будь-який час. Для отримання найактуальнішої інформації звертайтеся до останніх оголошень і фактичних даних, що відображаються на платформі Gate.
Інвестиції в цифрові активи пов'язані зі значними ризиками, а ціни можуть суттєво коливатися. Ви можете втратити всю суму своїх інвестицій. Приймайте рішення обережно, враховуючи власний фінансовий стан і рівень толерантності до ризику після повного розуміння супутніх ризиків. За потреби рекомендується звернутися до незалежного професійного фінансового чи юридичного радника.
Щоб отримати додаткову інформацію про потенційні ризики, зверніться до Розкриття інформації про ризики та Угоди користувача Gate.
