Perguntas Frequentes
Limites de Quantidade de Ordem
1. Limite de Quantidade Mínima: Gate Payment: 0.0001 (todas as unidades de moeda)
Pagamento On-Chain Web3: 0,01 USDT (ou equivalente em outras moedas)
Quantidade Mínima de Troca Flash: 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 do valor mínimo for 0.0001, o valor da ordem deve ser ≥ 0.0001, como 0.0001, 0.00011, etc.
2. Limite de Precisão: O número de casas decimais no valor da ordem 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.
O valor da ordem deve encontrar ambos o valor mínimo e os requisitos de precisão, caso contrário, não pode ser enviado. Por exemplo, se o o valor mínimo é 0.0001 e o o limite de precisão é 0,1, 0.01 ainda não atenderia 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-status-de-retiro
Descrição
O “Verificar Status de Retirada” A API permite que os usuários recuperem informações sobre as taxas de retirada para diferentes tokens em várias redes suportadas. Os usuários podem selecionar a rede conforme necessário.
Parâmetros de Taxa
retirada_fixa_na_rede: Taxa de retirada fixa
percentual_de_retirada_na_rede: Taxa de retirada baseada em porcentagem (aplicável a certos tokens especiais, calculada como Valor de Retirada × Taxa de Porcentagem)
Fórmula de Cálculo
Taxa de Retirada = Taxa Fixa + ( Taxa de Comissão em Percentagem × Valor de Retirada)
Notas Adicionais
As cadeias mais comumente usadas cobram apenas um taxa de retirada fixa, que atualizações a cada hora.
Por favor Faça uma solicitação de API antes de cada retirada para obter os dados mais recentes de taxas e garantir cálculos precisos.
Por 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 rede, não quando o usuário iniciou o pagamento. Um atraso pode ocorrer entre esses dois momentos.
Por que as faturas mostradas no aplicativo ou site da Gate diferem do pagamento real recebido?
O aplicativo ou site exibe 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 Ordens
- merchantTradeNo: O número do pedido no sistema do comerciante, 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ções de Callback para Pagamentos de Endereço na Rede
Por que há duas notificações de callback para pagamentos?
- Notificação de Chegada de Financiamento (TRANSFER_ADDRESS): Uma notificação sobre o financiamento recebido.
- Notificação de Mudança de Status da Ordem (Endereço de Pagamento): Uma notificação sobre mudanças no status da ordem.
Os comerciantes precisam confiar nesses dois tipos de informações para determinar se a ordem foi bem-sucedida para prosseguir com o envio ou lidar com ordens falhadas.
Quando as Notificações de Callback são Enviadas?
- Notificação de Chegada de Financiamento Enviado após o pagamento ser confirmado na rede, permitindo que os fundos sejam creditados na conta do comerciante em tempo real enquanto notifica o comerciante.
- Notificação de Mudança de Status da Ordem Acionado quando o status da ordem muda.
Entendendo 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 do pedido.
- TRANSFERRED_ADDRESS_DELAY: Os fundos recebidos após o período de validade são creditados na conta de pagamento do comerciante (crédito em tempo real após o período de validade).
- TRANSFERRED_ADDRESS_BLOCK: A transação tem potencial risco de segurança e é rejeitada. Por favor, entre em contato com o Gate Pay para assistência no reembolso do pagamento.
2. Notificação de Mudança de Status do Pedido (biztype = PAY_ADDRESS)
- PAY_SUCCESS: O pagamento foi bem-sucedido.
- PAY_CLOSE: O pedido expirou.
- PAY_EXPIRED_IN_PROCESS: Aguardando confirmação na rede dos fundos.
Cenários de Pagamento e Determinação de Status de Ordem para Pagamentos na rede Endereço
1. Pagamento total ou excesso dentro do período de validade
Descrição : Se um usuário pagar o valor total ou mais do que o requerido dentro do período de validade, uma vez confirmado na rede, ambos os callbacks são acionados.
Notificação de Status da Ordem :
- Inicialmente: bizStatus = PAY_EXPIRED_IN_PROCESS
- Após a confirmação: bizStatus = PAY_SUCCESS, doneAmountOnChain incluído.
Notificação de Chegada de Fundos : bizStatus = ENDEREÇO_TRANSFERIDO_NO_TERMO, valor creditado = transferAmount.
2. Pagamento Parcial dentro do Período de Validade
Descrição : O usuário paga menos do que o valor da ordem dentro do período de validade. Uma vez confirmado na rede, o valor é creditado e uma notificação de chegada de financiamento é enviada.
Notificação de Status da Ordem : Não acionado.
Notificação de Chegada de Financiamento : bizStatus = ENDEREÇO_TRANSFERIDO_EM_TERMO, amount = transferAmount.
3. Pagamento Parcial sem Suplemento
Descrição : O pagamento parcial foi feito, mas nenhum valor adicional é adicionado antes da expiração.
Notificação de Status da Ordem : Enviado após a expiração do pedido: bizStatus = PAY_CLOSE, amount = doneAmountOnChain.
Notificação de Chegada de Financiamento : Já enviado anteriormente quando os fundos chegaram. Não repetir callback.
4. Pagamento Parcial com Suplemento
4.1 Suplementado Dentro do Período de Validade Notificação de Status da Ordem :
- Após o suplemento: bizStatus = PAY_EXPIRED_IN_PROCESS
- Após confirmação: bizStatus = PAY_SUCCESS, doneAmountOnChain reflete o total recebido.
Notificação de Chegada de Financiamento : Enviado apenas após confirmação: bizStatus = ENDEREÇO_TRANSFERIDO_NO_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 de ordem após o suplemento tardio.
Notificação de Chegada de Financiamento :
- Após suplemento atrasado: bizStatus = TRANSFERRED_ADDRESS_DELAY, amount = transferAmount.
-
doneAmountOnChain não será incluído. Os comerciantes precisam agregar manualmente vários 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 Fundos :Ao atraso no pagamento: bizStatus = TRANSFERIDO_ENDEREÇO_ATRASO, amount = transferAmount. Sem doneAmountOnChain e sem callback de status de ordem para pagamentos pós-expiração. Os comerciantes devem somar todos os valores transferAmount recebidos..
O comerciante deve determinar o sucesso de uma ordem com base tanto no status da ordem quanto nas notificações de retorno de chegada de fundos.
