Documentação da API de Notificação de Callback do Gate Pay: https://docs.gate.com/api-reference/version/100/en/common/asyncNotification
Interpretação das Informações de Estado do Callback de Pagamento
Tipo de Endereço Dinâmico
1. Notificação de Receção de Fundos por Pagamento em Endereço Dinâmico (biztype = TRANSFER_ADDRESS)
TRANSFERRED_ADDRESS_IN_TERM: Os fundos são creditados instantaneamente durante o período de validade da encomenda.
TRANSFERRED_ADDRESS_DELAY: Se o pagamento for creditado após o período de validade, o valor efetivamente pago será creditado na conta de saldo do comerciante (crédito instantâneo após o período de validade).
2. Notificação de Alteração de Estado da Encomenda de Pagamento em Endereço Dinâmico (biztype = PAY_ADDRESS)
PAY_SUCCESS: Pagamento bem-sucedido.
PAY_CLOSE: Encomenda expirada.
PAY_EXPIRED_IN_PROCESS: A aguardar confirmação dos fundos na blockchain.
Tipo de Endereço Estático
1. Sucesso no Pagamento para Endereço Estático (biztype=PAY_FIXED_ADDRESS)
PAY_SUCCESS: Pagamento bem-sucedido e fundos creditados.
2. Endereço Estático Marcado como Endereço de Risco (biztype=FIXED_ADDRESS_RISK)
RISK_ADDRESS: O endereço estático foi sinalizado como endereço de risco.
Tipo de Pagamento por Endereço Anómalo
Para cada transação de pagamento anómala, o Gate Pay enviará uma notificação webhook ao respetivo comerciante.
O bizType para este tipo de pagamento é sempre PAY_UNRESOLVED.
Os comerciantes devem determinar o problema de faturação com base no errorType presente nos dados e consultar o Guia de Gestão de Pagamentos Anómalos do Gate Pay ou contactar o seu gestor de conta Gate Pay.
- address_risk_address
— Endereço dinâmico de alto risco - address_error_currency
— Moeda incorreta para endereço dinâmico - address_error_chain
— Rede blockchain incorreta para endereço dinâmico - fix_error_currency
— Moeda incorreta para endereço estático - fix_error_chain
— Rede blockchain incorreta para endereço estático - fix_risk_address
— Endereço estático de alto risco - fix_delete
— Endereço estático eliminado - fix_partial_delete
— Endereço estático parcialmente eliminado
Sobre as Informações de Callback para Pagamentos em Endereço Dinâmico
Porque Existem Dois Tipos de Informação de Callback de Pagamento?
- Notificação de Receção de Fundos (TRANSFER_ADDRESS): Notificação do valor efetivamente creditado.
- Notificação de Alteração de Estado da Encomenda (PAY_ADDRESS): Notificação de alterações no estado da encomenda.
Os comerciantes precisam de utilizar ambos os tipos de informação para determinar se uma encomenda foi bem-sucedida, de modo a prosseguir com a entrega ou gerir encomendas falhadas.
Quando São Enviadas as Notificações de Callback?
- Notificação de Receção de Fundos: Após a confirmação na blockchain de um pagamento bem-sucedido, os fundos são creditados em tempo real ao comerciante e é enviado um callback.
- Notificação de Alteração de Estado da Encomenda: É desencadeada quando há uma alteração no estado da encomenda.
Cenários de Pagamento em Endereço Dinâmico e Determinação do Estado da Encomenda
1. Pagamento Único do Valor Total ou Superior Dentro do Período de Validade
Descrição: Desde que o utilizador pague o valor total ou superior dentro do período de validade da encomenda, um callback é enviado em tempo real após a confirmação na blockchain.
Estado da Encomenda: Inicialmente, o sistema aguarda a confirmação dos fundos na blockchain e envia um callback com um estado intermédio: bizStatus é PAY_EXPIRED_IN_PROCESS. Após a confirmação na blockchain, a encomenda é bem-sucedida e é enviado um callback com bizStatus como PAY_SUCCESS e o montante creditado como doneAmountOnChain.
Notificação de Receção de Fundos: bizStatus é TRANSFERRED_ADDRESS_IN_TERM, montante creditado é transferAmount.
2. Pagamento Inferior ao Valor da Encomenda Dentro do Período de Validade
Descrição: Se o utilizador pagar menos do que o valor da encomenda dentro do período de validade, após confirmação na blockchain, o valor efetivamente pago é creditado ao comerciante e um callback de receção de fundos é enviado em tempo real.
Estado da Encomenda: Durante o período de validade, o estado da encomenda não se altera e não é enviado callback de alteração de estado da encomenda.
Notificação de Receção de Fundos: bizStatus é TRANSFERRED_ADDRESS_IN_TERM, montante creditado é transferAmount.
3. Pagamento Inferior ao Valor da Encomenda Dentro do Período de Validade, Não Regularizado
Descrição: Se o utilizador pagar menos do que o valor da encomenda dentro do período de validade e não regularizar a diferença durante esse período.
Estado da Encomenda: Quando termina o período de validade da encomenda, é enviado um callback de alteração de estado. bizStatus é PAY_CLOSE, montante creditado é doneAmountOnChain.
Notificação de Receção de Fundos: O callback de receção de fundos já foi enviado após o pagamento e não será reenviado.
4. Pagamento Inferior ao Valor da Encomenda Dentro do Período de Validade, Depois Regularizado
4.1 Regularização Dentro do Período de Validade:
Após o utilizador regularizar o valor em falta:
Estado da Encomenda: O sistema aguarda a confirmação dos fundos na blockchain e envia um callback com estado intermédio: bizStatus é PAY_EXPIRED_IN_PROCESS.
Notificação de Receção de Fundos: Não é enviada notificação de receção de fundos enquanto se aguarda a confirmação na blockchain do pagamento de regularização.
Após Confirmação na Blockchain:
Estado da Encomenda: Assim que os fundos são confirmados na blockchain e o valor total é suficiente, a encomenda é considerada bem-sucedida. bizStatus é PAY_SUCCESS, montante creditado é doneAmountOnChain (total de todos os pagamentos).
Notificação de Receção de Fundos: bizStatus é TRANSFERRED_ADDRESS_IN_TERM, montante creditado é transferAmount.
4.2 Regularização Após o Período de Validade:
Estado da Encomenda: Como o valor total não foi pago dentro do período de validade, é enviado um callback de alteração de estado quando termina o período de validade. bizStatus é PAY_CLOSE, montante creditado é doneAmountOnChain.
Notificação de Receção de Fundos: O callback de receção de fundos já foi enviado após o pagamento e não será reenviado.
Se o utilizador regularizar o valor em falta após o período de validade: é enviado um callback de receção de fundos com bizStatus como TRANSFERRED_ADDRESS_DELAY, montante creditado é transferAmount. (Neste caso, não é enviado callback adicional de alteração de estado da encomenda e o callback final não inclui o campo doneAmountOnChain. Se o utilizador completar o pagamento em várias transações, o comerciante deve somar todos os valores de transferAmount dos callbacks para confirmar o montante total creditado.)
5. Pagamento Expirado
Descrição: Se o utilizador pagar após o período de validade da encomenda, seja parcial, total ou superior ao valor, os fundos são creditados em tempo real após confirmação na blockchain.
Alteração de Estado da Encomenda: Como não houve pagamento durante o período de validade, é enviado um callback com bizStatus como PAY_CLOSE quando termina o período de validade.
Receção de Fundos: Não há notificação de receção de fundos.
Pagamento Após Expiração: Após a expiração, para cada pagamento efetuado, é enviada uma notificação de receção de fundos com bizStatus como TRANSFERRED_ADDRESS_DELAY, montante creditado é transferAmount. (Neste caso, não é enviado callback adicional de alteração de estado da encomenda e o callback final não inclui o campo doneAmountOnChain. Se o utilizador completar o pagamento em várias transações, o comerciante deve somar todos os valores de transferAmount dos callbacks para confirmar o montante total creditado.)
Os comerciantes devem utilizar tanto a informação de estado da encomenda como a de receção de fundos para determinar se a encomenda foi bem-sucedida.
6. Informação de Callback de Encomenda Anómala para Pagamentos em Endereço Dinâmico
6.1 Pagamento com Moeda ou Rede Blockchain Diferente da Encomenda
O comerciante receberá um callback com Biztype=PAY_UNRESOLVED e data.errorType=address_error_currency ou address_error_chain.
6.2 Fundos Sinalizados como de Risco e Intercetados
O comerciante receberá um callback com biztype=PAY_UNRESOLVED e data.errorType=address_risk_address.
Sobre as Informações de Callback para Endereços Estáticos
1. Pagamento Bem-Sucedido e Creditado
Será recebida uma notificação PAY_SUCCESS, indicando que o pagamento foi bem-sucedido e os fundos foram creditados.
2. Callback de Pagamento Anómalo
2.1 Pagamento com Moeda/Rede Diferente da Encomenda
O comerciante receberá um callback com biztype=PAY_UNRESOLVED e data.errorType=fix_error_currency ou fix_error_chain.
2.2 Fundos de Risco
O comerciante receberá um callback com biztype=PAY_UNRESOLVED e data.errorType=fix_risk_address.
2.3 Pagamento Enviado para um Endereço Estático Eliminado
O comerciante receberá um callback com biztype=PAY_UNRESOLVED e data.errorType=fix_delete ou fix_partial_delete.
3. Notificação de Risco de Endereço Estático
Será recebida uma notificação com bizType=FIXED_ADDRESS_RISK e bizStatus=RISK_ADDRESS, indicando que o endereço estático de receção associado ao comerciante foi identificado como endereço de risco. Os comerciantes devem eliminar imediatamente o endereço estático correspondente. Se os utilizadores continuarem a efetuar pagamentos para este endereço, os fundos não serão creditados.
Isenção de responsabilidade
O conteúdo aqui disponibilizado destina-se apenas a fins de referência e educativos, não constituindo qualquer aconselhamento financeiro, de investimento, de negociação ou jurídico, nem representa uma oferta ou solicitação para comprar ou vender quaisquer ativos digitais. A Gate não assume quaisquer declarações ou garantias, expressas ou implícitas, quanto à exatidão, integridade ou atualidade das informações aqui contidas. As funcionalidades dos produtos, interfaces, regras e estruturas de comissões podem ser atualizadas ou ajustadas a qualquer momento. Consulte os anúncios mais recentes e a informação efetivamente apresentada na plataforma Gate para obter os dados mais precisos.
Os investimentos em ativos digitais envolvem riscos significativos, podendo os preços variar substancialmente. Existe a possibilidade de perder a totalidade do montante investido. Tome decisões de forma cautelosa, tendo em conta a sua situação financeira e tolerância ao risco, após compreender plenamente os riscos associados. Se necessário, recomenda-se consultar um consultor financeiro ou jurídico independente.
Para mais informações sobre potenciais riscos, consulte a Divulgação de Riscos e o Acordo de Utilizador da Gate.
