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
— Статический адрес частично удалён

О callback-уведомлениях для платежей на динамические адреса

Почему существует два типа callback-уведомлений о платеже?

Уведомление о поступлении средств (TRANSFER_ADDRESS): Оповещение о фактически зачисленной сумме.
Уведомление об изменении статуса заказа (PAY_ADDRESS): Оповещение об изменениях статуса заказа.

Мерчантам необходимо использовать оба типа информации для определения успешности заказа, чтобы можно было выполнить доставку или обработать неудачные заказы.

Когда отправляются callback-уведомления?

Уведомление о поступлении средств: После подтверждения оплаты в блокчейне средства зачисляются мерчанту в реальном времени, и мерчанту отправляется callback.
Уведомление об изменении статуса заказа: Срабатывает при изменении статуса заказа.

Сценарии оплаты на динамический адрес и определение статуса заказа

1. Одноразовая полная оплата или переплата в течение срока действия

Описание: Если пользователь оплачивает полную сумму или больше в течение срока действия заказа, после подтверждения в блокчейне отправляется callback в реальном времени.
Статус заказа: Изначально система ожидает подтверждения средств в блокчейне и отправляет callback с промежуточным статусом: bizStatus — PAY_EXPIRED_IN_PROCESS. После подтверждения в блокчейне заказ считается успешным, и отправляется callback со статусом bizStatus — PAY_SUCCESS и зачисленной суммой в doneAmountOnChain.
Уведомление о поступлении средств: bizStatus — TRANSFERRED_ADDRESS_IN_TERM, зачисленная сумма — transferAmount.

2. Недоплата в течение срока действия

Описание: Если пользователь оплачивает сумму меньше требуемой в течение срока действия заказа, после подтверждения в блокчейне фактически уплаченная сумма зачисляется мерчанту, и callback о поступлении средств отправляется в реальном времени.
Статус заказа: В течение срока действия статус заказа не меняется, callback о статусе заказа не отправляется.
Уведомление о поступлении средств: bizStatus — TRANSFERRED_ADDRESS_IN_TERM, зачисленная сумма — transferAmount.

3. Недоплата в течение срока действия, без доплаты

Описание: Если пользователь оплачивает сумму меньше требуемой в течение срока действия заказа и не доплачивает оставшуюся сумму в этот период.
Статус заказа: По окончании срока действия отправляется callback о статусе заказа. bizStatus — PAY_CLOSE, зачисленная сумма — doneAmountOnChain.
Уведомление о поступлении средств: Callback о поступлении средств уже был отправлен после оплаты и повторно не отправляется.

4. Недоплата в течение срока действия, затем доплата

4.1 Доплата в течение срока действия:
После того, как пользователь доплатил недостающую сумму:
Статус заказа: Система ожидает подтверждения средств в блокчейне и отправляет callback с промежуточным статусом: bizStatus — PAY_EXPIRED_IN_PROCESS.
Уведомление о поступлении средств: Пока ожидается подтверждение доплаты в блокчейне, уведомление о поступлении средств не отправляется.
После подтверждения в блокчейне:
Статус заказа: После подтверждения средств в блокчейне и достижения необходимой суммы заказ считается успешным. bizStatus — PAY_SUCCESS, зачисленная сумма — doneAmountOnChain (сумма всех платежей).
Уведомление о поступлении средств: bizStatus — TRANSFERRED_ADDRESS_IN_TERM, зачисленная сумма — transferAmount.

4.2 Доплата после истечения срока действия:
Статус заказа: Так как полная сумма не была оплачена в течение срока действия, по окончании срока отправляется callback о статусе заказа. bizStatus — PAY_CLOSE, зачисленная сумма — doneAmountOnChain.
Уведомление о поступлении средств: Callback о поступлении средств уже был отправлен после оплаты и повторно не отправляется.
Если пользователь доплачивает после истечения срока действия: отправляется callback о поступлении средств со статусом bizStatus — TRANSFERRED_ADDRESS_DELAY, зачисленная сумма — transferAmount. (В этом случае дополнительный callback о статусе заказа не отправляется, а финальный callback не содержит поле doneAmountOnChain. Если пользователь совершил несколько платежей, мерчанту необходимо суммировать все значения transferAmount из callback-уведомлений для подтверждения общей зачисленной суммы.)

5. Просроченная оплата

Описание: Если пользователь оплачивает после истечения срока действия заказа — частично, полностью или с переплатой — средства зачисляются в реальном времени после подтверждения в блокчейне.
Изменение статуса заказа: Так как в течение срока действия оплата не поступила, по окончании срока отправляется callback со статусом bizStatus — PAY_CLOSE.
Поступление средств: Уведомление о поступлении средств не отправляется.
Оплата после истечения срока: После истечения срока на каждую оплату отправляется уведомление о поступлении средств со статусом bizStatus — TRANSFERRED_ADDRESS_DELAY, зачисленная сумма — transferAmount. (В этом случае дополнительный callback о статусе заказа не отправляется, а финальный callback не содержит поле doneAmountOnChain. Если пользователь совершил несколько платежей, мерчанту необходимо суммировать все значения transferAmount из callback-уведомлений для подтверждения общей зачисленной суммы.)
Мерчантам необходимо использовать как информацию о статусе заказа, так и callback о поступлении средств для определения успешности заказа.

6. Callback-информация об аномальных заказах для платежей на динамические адреса

6.1 Оплата другой валютой или в другой блокчейн-сети, чем указано в заказе
Мерчант получит callback с Biztype=PAY_UNRESOLVED и data.errorType=address_error_currency или address_error_chain.

6.2 Средства помечены как рискованные и заблокированы
Мерчант получит callback с biztype=PAY_UNRESOLVED и data.errorType=address_risk_address.

О callback-уведомлениях для статических адресов

1. Успешная оплата и зачисление средств

Будет получено уведомление PAY_SUCCESS, что означает успешную оплату и зачисление средств.

2. Callback при аномальной оплате

2.1 Оплата другой валютой/сетью, чем указано в заказе
Мерчант получит callback с biztype=PAY_UNRESOLVED и data.errorType=fix_error_currency или fix_error_chain.

2.2 Рискованные средства
Мерчант получит callback с biztype=PAY_UNRESOLVED и data.errorType=fix_risk_address.

2.3 Оплата на удалённый статический адрес
Мерчант получит callback с biztype=PAY_UNRESOLVED и data.errorType=fix_delete или fix_partial_delete.

3. Уведомление о риске статического адреса

Будет получено уведомление с bizType=FIXED_ADDRESS_RISK и bizStatus=RISK_ADDRESS, что означает, что статический адрес для приёма платежей, привязанный к мерчанту, был определён как рискованный. Мерчантам следует немедленно удалить соответствующий статический адрес. Если пользователи продолжат отправлять средства на этот адрес, зачисление не произойдёт.

Отказ от ответственности

Содержимое, представленное здесь, предназначено только для справочных и образовательных целей и не является финансовой, инвестиционной, торговой или юридической консультацией, а также не представляет собой предложение или призыв к покупке или продаже каких-либо цифровых активов. Gate не дает никаких явных или подразумеваемых гарантий относительно точности, полноты или актуальности информации, содержащейся в этом материале. Функционал продукта, интерфейсы, правила и структура комиссий могут быть обновлены или изменены в любой момент. Для получения самой точной информации ознакомьтесь с последними объявлениями и фактическими данными, отображаемыми на платформе Gate.

Инвестиции в цифровые активы связаны с существенными рисками, их стоимость может значительно меняться. Вы можете потерять всю сумму своих вложений. Принимайте решения осознанно, учитывая собственное финансовое положение и уровень допустимого риска, после полного ознакомления со всеми сопутствующими рисками. При необходимости рекомендуется проконсультироваться с независимым профессиональным финансовым или юридическим консультантом.

Для получения дополнительной информации о возможных рисках ознакомьтесь с Раскрытием рисков и Пользовательским соглашением Gate.

Интерпретация обратного вызова Gate Pay ｜ Gate

Интерпретация статуса callback-уведомлений о платеже

Динамический тип адреса