Gate Pay Documentação da API de Notificação de Callback: https://docs.gate.com/api-reference/version/100/en/common/asyncNotification
Interpretando as Informações de Status do Callback de Pagamento
Tipo de Endereço Dinâmico
1. Notificação de Crédito de Fundos em Pagamento por Endereço Dinâmico (biztype = TRANSFER_ADDRESS)
TRANSFERRED_ADDRESS_IN_TERM: Fundos creditados instantaneamente dentro do período de validade do pedido.
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 Status do Pedido de Pagamento por Endereço Dinâmico (biztype = PAY_ADDRESS)
PAY_SUCCESS: Pagamento bem-sucedido.
PAY_CLOSE: Pedido expirado.
PAY_EXPIRED_IN_PROCESS: Aguardando confirmação dos fundos na blockchain.
Tipo de Endereço Estático
1. Sucesso no Pagamento por 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 um endereço de risco.
Tipo de Pagamento por Endereço Anormal
Para cada transação de pagamento anormal, o Gate Pay enviará uma notificação webhook para o respectivo comerciante.
O bizType para este tipo de pagamento é sempre PAY_UNRESOLVED.
Os comerciantes devem identificar o problema de faturamento com base no errorType presente nos dados e consultar o Guia de Tratamento de Pagamentos Anormais do Gate Pay ou entrar em contato com seu gerente 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 excluído - fix_partial_delete
— Endereço estático parcialmente excluído
Sobre as Informações de Callback para Pagamentos com Endereço Dinâmico
Por Que Existem Dois Tipos de Informações de Callback de Pagamento?
- Notificação de Crédito de Fundos (TRANSFER_ADDRESS): Notificação do valor efetivamente creditado.
- Notificação de Alteração de Status do Pedido (PAY_ADDRESS): Notificação de mudanças no status do pedido.
Os comerciantes precisam utilizar ambos os tipos de informações para determinar se um pedido foi bem-sucedido, para então prosseguir com a entrega ou tratar pedidos malsucedidos.
Quando as Notificações de Callback São Enviadas?
- Notificação de Crédito de Fundos: Após a confirmação do pagamento na blockchain, os fundos são creditados em tempo real ao comerciante e um callback é enviado.
- Notificação de Alteração de Status do Pedido: Disparada quando há alteração no status do pedido.
Cenários de Pagamento por Endereço Dinâmico e Determinação do Status do Pedido
1. Pagamento Único, Integral ou Superior ao Valor, Dentro do Período de Validade
Descrição: Desde que o usuário pague o valor total ou superior dentro do período de validade do pedido, um callback é enviado em tempo real após a confirmação na blockchain.
Status do Pedido: Inicialmente, o sistema aguarda a confirmação dos fundos na blockchain e envia um callback com status intermediário: bizStatus é PAY_EXPIRED_IN_PROCESS. Após a confirmação na blockchain, o pedido é considerado bem-sucedido e um callback é enviado com bizStatus como PAY_SUCCESS e o valor creditado como doneAmountOnChain.
Notificação de Crédito de Fundos: bizStatus é TRANSFERRED_ADDRESS_IN_TERM, valor creditado é transferAmount.
2. Pagamento Inferior ao Valor do Pedido Dentro do Período de Validade
Descrição: Se o usuário pagar menos do que o valor do pedido dentro do período de validade, após a confirmação na blockchain, o valor efetivamente pago é creditado ao comerciante e um callback de crédito de fundos é enviado em tempo real.
Status do Pedido: Dentro do período de validade, o status do pedido não muda e não é enviado callback de status do pedido.
Notificação de Crédito de Fundos: bizStatus é TRANSFERRED_ADDRESS_IN_TERM, valor creditado é transferAmount.
3. Pagamento Inferior ao Valor do Pedido Dentro do Período de Validade, Sem Complementação
Descrição: Se o usuário pagar menos do que o valor do pedido dentro do período de validade e não complementar a diferença durante esse período.
Status do Pedido: Quando o período de validade termina, um callback de status do pedido é enviado. bizStatus é PAY_CLOSE, valor creditado é doneAmountOnChain.
Notificação de Crédito de Fundos: O callback de crédito de fundos já foi enviado após o pagamento e não será reenviado.
4. Pagamento Inferior ao Valor do Pedido Dentro do Período de Validade, Com Complementação Posterior
4.1 Complementação Dentro do Período de Validade:
Após o usuário complementar o valor restante:
Status do Pedido: O sistema aguarda a confirmação dos fundos na blockchain e envia um callback com status intermediário: bizStatus é PAY_EXPIRED_IN_PROCESS.
Notificação de Crédito de Fundos: Não é enviada notificação de crédito de fundos enquanto aguarda a confirmação na blockchain da complementação.
Após a Confirmação na Blockchain:
Status do Pedido: Assim que os fundos forem confirmados na blockchain e o valor total for suficiente, o pedido é considerado bem-sucedido. bizStatus é PAY_SUCCESS, valor creditado é doneAmountOnChain (soma de todos os pagamentos).
Notificação de Crédito de Fundos: bizStatus é TRANSFERRED_ADDRESS_IN_TERM, valor creditado é transferAmount.
4.2 Complementação Após o Período de Validade:
Status do Pedido: Como o valor total não foi pago dentro do período de validade, um callback de status do pedido é enviado ao final do período. bizStatus é PAY_CLOSE, valor creditado é doneAmountOnChain.
Notificação de Crédito de Fundos: O callback de crédito de fundos já foi enviado após o pagamento e não será reenviado.
Se o usuário complementar o valor após o período de validade: um callback de crédito de fundos é enviado com bizStatus como TRANSFERRED_ADDRESS_DELAY, valor creditado é transferAmount. (Neste caso, não há envio adicional de callback de status do pedido e o callback final não inclui o campo doneAmountOnChain. Se o usuário completar o pagamento em múltiplas transações, o comerciante deve somar todos os valores de transferAmount dos callbacks para confirmar o total creditado.)
5. Pagamento Expirado
Descrição: Se o usuário pagar após o período de validade do pedido, seja parcialmente, integralmente ou valor superior, os fundos são creditados em tempo real após a confirmação na blockchain.
Alteração de Status do Pedido: Como não houve pagamento durante o período de validade, um callback é enviado com bizStatus como PAY_CLOSE quando o período termina.
Crédito de Fundos: Não há notificação de crédito de fundos.
Pagamento Após a Expiração: Após a expiração, para cada pagamento realizado, uma notificação de crédito de fundos é enviada com bizStatus como TRANSFERRED_ADDRESS_DELAY, valor creditado é transferAmount. (Neste caso, não há envio adicional de callback de status do pedido e o callback final não inclui o campo doneAmountOnChain. Se o usuário completar o pagamento em múltiplas transações, o comerciante deve somar todos os valores de transferAmount dos callbacks para confirmar o total creditado.)
Os comerciantes precisam utilizar tanto as informações de status do pedido quanto as de crédito de fundos para determinar se o pedido foi bem-sucedido.
6. Informações de Callback de Pedido Anormal para Pagamentos com Endereço Dinâmico
6.1 Pagamento com Moeda ou Rede Blockchain Diferente da do Pedido
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 Interceptados
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 Fundos Creditados
Uma notificação PAY_SUCCESS será recebida, indicando que o pagamento foi bem-sucedido e os fundos foram creditados.
2. Callback de Pagamento Anormal
2.1 Pagamento com Moeda/Rede Diferente da do Pedido
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 Endereço Estático Excluído
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
Uma notificação será recebida com bizType=FIXED_ADDRESS_RISK e bizStatus=RISK_ADDRESS, indicando que o endereço estático de recebimento vinculado ao comerciante foi identificado como endereço de risco. Os comerciantes devem excluir imediatamente o endereço estático correspondente. Se os usuários continuarem realizando pagamentos para esse endereço, os fundos não serão creditados.
Isenção de responsabilidade
O conteúdo aqui fornecido é apenas para fins de referência e educacionais e não constitui qualquer conselho financeiro, de investimento, de negociação ou jurídico, nem constitui uma oferta ou solicitação para comprar ou vender quaisquer ativos digitais. A Gate não faz representações ou garantias expressas ou implícitas em relação à precisão, integridade ou atualidade das informações aqui contidas. Recursos, interfaces, regras e estruturas de taxas dos produtos podem ser atualizados ou ajustados a qualquer momento. Consulte os anúncios mais recentes e as informações reais exibidas na plataforma Gate para obter os detalhes mais precisos.
Os investimentos em ativos digitais envolvem riscos significativos e os preços podem flutuar substancialmente. Você pode perder o valor total do seu investimento. Tome decisões com cautela, com base em sua própria situação financeira e tolerância ao risco, após compreender totalmente os riscos associados. Se necessário, recomenda-se consultar um consultor financeiro ou jurídico profissional independente.
Para mais informações sobre possíveis riscos, consulte a Divulgação de Riscos e o Termo de Acordo do Usuário da Gate.
