Perguntas Frequentes
Limites de Montante da Ordem
1. Limite de Montante Mínimo: Gate Payment: 0.0001 (todas as unidades de moeda)
Pagamento na cadeia Web3: 0,01 USDT (ou equivalente em outras moedas)
Montante Mínimo de Troca Rápida: A API de consulta de pares de moedas retornará os valores máximo e mínimo.
O valor da ordem não pode ser inferior ao valor mínimo definido. Por exemplo, se o limite de valor 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 na quantidade do pedido não deve exceder a precisão definida. Por exemplo, se a precisão estiver definida para 0.0001 (ou seja, até 4 casas decimais), 0.001 é válido, mas 0.00011 resultará em um erro e não será arredondado.
A quantidade da ordem deve encontrar ambos o montante mínimo e os requisitos de precisão, caso contrário, não pode ser submetido. Por exemplo, se o o montante mínimo é 0.0001 e o o limite de precisão é 0.1, 0.01 não atenderia ainda ao requisito de precisão e resultaria em um erro.
Explicação da Taxa de Retirada
API para Verificar o Status de Retirada
https://www.gate.com/docs/developers/apiv4/pt/#recuperar-o-status-da-retração
Descrição
O "Verificar Status de Retirada" A API permite que os usuários recuperem informações sobre taxas de retirada para diferentes tokens em cadeias suportadas. Os usuários podem selecionar a cadeia conforme necessário.
Parâmetros de Taxa
retirada_fix_na_cadeia: Taxa fixa de levantamento
percentagem_retirada_na_cadeia: Taxa de retirada baseada em porcentagem (aplicável a certos tokens especiais, calculada como Valor de Retirada × Taxa Percentual)
Fórmula de Cálculo
Taxa de Retirada = Taxa Fixa + ( Taxa de Comissão Percentual × Montante de Retirada)
Notas Adicionais
As cadeias mais utilizadas cobram apenas um taxa de retirada fixa, que atualizações a cada hora.
Por favor Faça uma solicitação API antes de cada retirada para obter os dados de taxas mais recentes e garantir cálculos precisos.
Por que é que um pagamento feito dentro do período de validade é marcado como uma ordem expirada?
O tempo de pagamento é determinado com base em quando a transação é detectada na cadeia, não quando o usuário iniciou o pagamento. Pode ocorrer um atraso entre esses dois momentos.
Por que as faturas mostradas no aplicativo ou site da Gate diferem do pagamento real recebido?
O aplicativo ou a web exibem o valor da ordem, não o valor real pago pelo usuário. Mesmo que o pagamento do usuário difira do valor da ordem, o valor da ordem ainda será exibido. Para faturamento detalhado, consulte sempre o backend do comerciante.
Significado de merchantTradeNo e merchantUserId na API de Criação de Ordem
- merchantTradeNo: O número da ordem no sistema do merch, com um comprimento máximo de 32 caracteres.
- merchantUserId: O ID da conta do usuário no sistema do comerciante. Este deve ser um ID de usuário válido; caso contrário, os reembolsos relacionados ao pagamento para o endereço falharão, pois o sistema não consegue identificar o usuário.
Informação de Retorno para Pagamentos de Endereço na Cadeia
Por que existem duas notificações de callback para pagamentos?
- Notificação de Chegada de Fundos (TRANSFER_ADDRESS): Uma notificação sobre o financiamento recebido.
- Notificação de Alteração de Status da Ordem (PA): Uma notificação sobre mudanças no status da ordem.
Os comerciantes precisam confiar nesses dois tipos de informação para determinar se a ordem é bem-sucedida para prosseguir com o envio ou lidar com ordens falhadas.
Quando são enviadas as Notificações de Callback?
- Notificação de Chegada de Financiamento Enviado após a confirmação do pagamento na cadeia, permitindo que os fundos sejam creditados na conta do comerciante em tempo real enquanto notifica o comerciante.
- Notificação de Alteração do Status da Ordem Acionado quando o status da ordem muda.
Compreendendo o Status do Callback
1. Notificação de Chegada de Fundos (biztype = TRANSFER_ADDRESS)
- TRANSFERRED_ADDRESS_IN_TERM: Os fundos são 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 merch (crédito em tempo real após o período de validade).
- TRANSFERRED_ADDRESS_BLOCK: A transação apresenta risco de segurança potencial e é rejeitada. Por favor, entre em contato com o suporte Gate para assistência no reembolso do pagamento.
2. Notificação de Mudança de Estado da Ordem (biztype = PAY_ADDRESS)
- PAY_SUCCESS: O pagamento foi bem-sucedido.
- PAY_CLOSE: A ordem expirou.
- PAY_EXPIRED_IN_PROCESS: Aguardando confirmação na cadeia dos fundos.
Cenários de Pagamento e Determinação do Status da Ordem para Pagamentos de Endereço na Cadeia
1. Pagamento total ou excessivo dentro do Período de Validade
Descrição : Se um utilizador pagar o montante total ou mais do que o montante exigido dentro do período de validade, uma vez confirmado na cadeia, ambos os callbacks são acionados.
Notificação de Status da Ordem :
- Inicialmente: bizStatus = PAY_EXPIRED_IN_PROCESS
- Após confirmação: bizStatus = PAY_SUCCESS, doneAmountOnChain incluído.
Notificação de Chegada de Financiamento : bizStatus = ENDEREÇO_TRANSFERIDO_EM_TERMO, credited amount = 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. Uma vez confirmado na cadeia, o montante é creditado e uma notificação de chegada de financiamento é enviada.
Notificação de Status de Ordem : Não acionado.
Notificação de Chegada de Fundos : bizStatus = ENDEREÇO_TRANSFERIDO_NO_TERMO, amount = transferAmount.
3. Pagamento Parcial sem Suplemento
Descrição : O pagamento parcial é efetuado, mas nenhum montante adicional é adicionado antes da expiração.
Notificação de Status da Ordem : Enviado após a expiração da ordem: bizStatus = PAY_CLOSE, amount = doneAmountOnChain.
Notificação de Chegada de Financiamento : Já enviado anteriormente quando os fundos chegaram. Nenhuma chamada de retorno repetida.
4. Pagamento Parcial com Suplemento
4.1 Suplementado Dentro do Período de Validade Notificação de Status da Ordem :
- Após suplemento: bizStatus = PAY_EXPIRED_IN_PROCESS
- Após confirmação: bizStatus = PAY_SUCCESS, doneAmountOnChain reflete o total recebido.
Notificação de Chegada de Fundos : Enviado apenas após confirmação: bizStatus = ENDEREÇO_TRANSFERIDO_EM_TERMO, amount = transferAmount.
4.2 Suplementado Após o Período de Validade
Notificação de Status da Ordem :
- Na expiração: bizStatus = PAY_CLOSE, amount = doneAmountOnChain.
-
Nenhuma notificação adicional de status da ordem após o suplemento tardio.
Notificação de Chegada de Financiamento :
- Após suplemento tardio: bizStatus = TRANSFERRED_ADDRESS_DELAY, amount = transferAmount.
-
doneAmountOnChain não será incluído. Os comerciantes precisam agregar manualmente múltiplos valores de transferAmount.
5. Pagamento Feito Após Expiração
Descrição : O usuário paga após a ordem ter expirado, independentemente do valor.
Notificação de Status da Ordem : Na expiração: bizStatus = PAY_CLOSE.
Notificação de Chegada de Financiamento :Após pagamento tardio: bizStatus = TRANSFERRED_ADDRESS_DELAY, amount = transferAmount. Não há doneAmountOnChain e nem callback de status de ordem para pagamentos pó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 status da ordem quanto nas notificações de callback de chegada de fundos.
