Central de Ajuda
Gate Pay
Guia de integração de comerciante

FAQ do Gate Pay | Gate

28/05/2026 (UTC)
37 031 Lido
3

Perguntas Frequentes

Limites de Montante de Ordem

1. Limite Mínimo de Montante:
Gate Payment: 0,0001 (todas as unidades monetárias)
Web3 Pagamento On-Chain: 0,01 USDT (ou equivalente noutras moedas)
Montante Mínimo de Troca Flash: A API de consulta do par de moedas irá devolver os valores máximo e mínimo.

O montante da ordem não pode ser inferior ao montante mínimo definido. Por exemplo, se o limite mínimo for 0,0001, o montante da ordem deve ser ≥ 0,0001, como 0,0001, 0,00011, etc.

2. Limite de Precisão:
O número de casas decimais do montante da ordem não pode exceder a precisão definida. Por exemplo, se a precisão for definida para 0,0001 (ou seja, até 4 casas decimais), 0,001 é válido, mas 0,00011 resultará num erro e não será arredondado.

O montante da ordem deve cumprir ambos os requisitos de montante mínimo e precisão, caso contrário, não pode ser submetido. Por exemplo, se o montante mínimo for 0,0001 e o limite de precisão for 0,1, 0,01 ainda não cumpre o requisito de precisão e resultará num erro.


Descrição da Taxa de Levantamento

API de Taxa de Levantamento

https://docs.gate.com/api-reference/version/100/en/endpoint/withdraw/withdrawStatus

Descrição

Ao chamar a API “Consulta de Taxa de Levantamento”, serão devolvidas as taxas exigidas para cada rede blockchain suportada pela moeda. Os utilizadores podem escolher a cadeia apropriada conforme as suas necessidades.

Consulte os dois parâmetros seguintes:

Parâmetros de Taxa

  • withdraw_fix_on_chains : Taxa fixa de levantamento
  • withdraw_percent_on_chains : Taxa percentual de levantamento
    (Para algumas moedas especiais, a taxa de levantamento é calculada como montante de levantamento × esta percentagem)

Método de Cálculo

A taxa de levantamento é a soma das seguintes duas partes:
Taxa fixa + (taxa percentual × montante de levantamento)

Outras Notas

Atualmente, a maioria das cadeias mais utilizadas cobra apenas uma taxa fixa
(a taxa fixa é atualizada de hora a hora).

Recomenda-se chamar esta API sempre que efetuar um levantamento para confirmar a taxa mais recente, pois as taxas de levantamento são atualizadas a cada hora.


Porque é que um pagamento feito dentro do período de validade é marcado como ordem expirada?

O tempo de pagamento é determinado com base no momento em que a transação é detetada on-chain, e não quando o utilizador iniciou o pagamento. Pode ocorrer um atraso entre estes dois momentos.


Porque é que os Registos de Receita e Despesa de Faturação são Inconsistentes entre a App Gate e o Painel do Comerciante

A informação de faturação apresentada no painel de comerciante do Gate Pay corresponde à conta de saldo do comerciante
(esta conta está disponível apenas para comerciantes registados no Gate Pay). É usada principalmente para operações de recolha e distribuição de fundos do comerciante.

A App Gate, por outro lado, é uma conta pessoal na exchange Gate.

Como a conta de saldo do comerciante e a conta pessoal são independentes uma da outra, os fundos e registos de faturação não são partilhados entre elas. Assim, a informação de faturação apresentada na App Gate ou na plataforma Web pode diferir dos registos reais de aquisição (recolha).


Significado de merchantTradeNo e merchantUserId na API Create Order

  1. merchantTradeNo: O número da ordem no sistema do comerciante, com comprimento máximo de 32 caracteres.
  2. merchantUserId: O ID da conta de utilizador no sistema do comerciante. Deve ser um ID de utilizador válido; caso contrário, reembolsos relacionados com o pagamento para o endereço irão falhar, pois o sistema não conseguirá identificar o utilizador.

Informação de Callback para Pagamentos para Endereços On-chain

Porque Existem Duas Notificações de Callback para Pagamentos?

  1. Notificação de Chegada de Fundos (TRANSFER_ADDRESS): Notificação sobre a receção dos fundos.
  2. Notificação de Alteração de Estado da Ordem (PAY_ADDRESS): Notificação sobre alterações no estado da ordem.

Os comerciantes devem basear-se nestes dois tipos de informação para determinar se a ordem foi bem-sucedida para proceder ao envio ou para lidar com ordens falhadas.

Quando São Enviadas as Notificações de Callback?

  1. Notificação de Chegada de Fundos
    Enviada após a confirmação do pagamento on-chain, permitindo que os fundos sejam creditados em tempo real na conta do comerciante, notificando-o simultaneamente.
  2. Notificação de Alteração de Estado da Ordem
    Disparada quando o estado da ordem é alterado.

Compreender o Estado do Callback

1. Notificação de Chegada de Fundos (biztype = TRANSFER_ADDRESS)

  • TRANSFERRED_ADDRESS_IN_TERM: Fundos creditados em tempo real dentro do período de validade da ordem.
  • TRANSFERRED_ADDRESS_DELAY: Fundos recebidos após o período de validade são creditados na conta de pagamento do comerciante (crédito em tempo real pós-validação).
  • TRANSFERRED_ADDRESS_BLOCK: A transação apresenta potencial risco de segurança e é rejeitada. Por favor, contacte o Gate Pay para assistência no reembolso do pagamento.

2. Notificação de Alteração de Estado da Ordem (biztype = PAY_ADDRESS)

  • PAY_SUCCESS: O pagamento foi bem-sucedido.
  • PAY_CLOSE: A ordem expirou.
  • PAY_EXPIRED_IN_PROCESS: A aguardar confirmação on-chain dos fundos.

Cenários de Pagamento e Determinação do Estado da Ordem para Pagamentos para Endereços On-chain

1. Pagamento Total ou Superior Dentro do Período de Validade

Descrição : Se um utilizador pagar o valor total ou mais do que o exigido dentro do período de validade, após confirmação on-chain, ambos os callbacks são acionados.
Notificação de Estado da Ordem :

  • Inicialmente: bizStatus = PAY_EXPIRED_IN_PROCESS
  • Após confirmação: bizStatus = PAY_SUCCESS, doneAmountOnChain incluído.

Notificação de Chegada de Fundos : bizStatus = TRANSFERRED_ADDRESS_IN_TERM, montante creditado = transferAmount.


2. Pagamento Parcial Dentro do Período de Validade

Descrição : O utilizador paga menos do que o montante da ordem dentro do período de validade. Após confirmação on-chain, o montante é creditado e é enviada uma notificação de chegada de fundos.
Notificação de Estado da Ordem : Não é acionada.
Notificação de Chegada de Fundos : bizStatus = TRANSFERRED_ADDRESS_IN_TERM, montante = transferAmount.


3. Pagamento Parcial sem Complemento

Descrição : É feito um pagamento parcial, mas não é adicionado mais nenhum montante antes da expiração.
Notificação de Estado da Ordem : Enviada aquando da expiração da ordem: bizStatus = PAY_CLOSE, montante = doneAmountOnChain.
Notificação de Chegada de Fundos : Já enviada anteriormente aquando da chegada dos fundos. Sem repetição de callback.


4. Pagamento Parcial com Complemento

4.1 Complementado Dentro do Período de Validade
Notificação de Estado da Ordem :

  • Após complemento: bizStatus = PAY_EXPIRED_IN_PROCESS
  • Após confirmação: bizStatus = PAY_SUCCESS, doneAmountOnChain reflete o total recebido.

Notificação de Chegada de Fundos : Enviada apenas após confirmação: bizStatus = TRANSFERRED_ADDRESS_IN_TERM, montante = transferAmount.

4.2 Complementado Após o Período de Validade

Notificação de Estado da Ordem :

  • Na expiração: bizStatus = PAY_CLOSE, montante = doneAmountOnChain.
  • Sem notificação adicional de estado da ordem após complemento tardio.

Notificação de Chegada de Fundos :

  • Após complemento tardio: bizStatus = TRANSFERRED_ADDRESS_DELAY, montante = transferAmount.
  • doneAmountOnChain não será incluído. Os comerciantes devem somar manualmente vários valores de transferAmount.

5. Pagamento Efetuado Após a Expiração

Descrição : O utilizador paga após a ordem ter expirado, independentemente do montante.
Notificação de Estado da Ordem : Na expiração: bizStatus = PAY_CLOSE.
Notificação de Chegada de Fundos : Após pagamento tardio: bizStatus = TRANSFERRED_ADDRESS_DELAY, montante = transferAmount. Sem doneAmountOnChain e sem callback de estado da ordem para pagamentos após expiração. Os comerciantes devem somar todos os valores de transferAmount recebidos.


O comerciante deve determinar o sucesso de uma ordem com base tanto no estado da ordem como nas notificações de chegada de fundos.

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.

Inscreva-se agora para ter a oportunidade de ganhar até $10,000!
signup-tips