Visão Geral do Produto
Os Pagamentos por Subscrição do Gate Pay oferecem-lhe capacidades de dedução automática de stablecoins baseadas em blockchain, permitindo-lhe cobrar automaticamente USDT ou USDC aos seus utilizadores em redes compatíveis com EVM, de acordo com um calendário definido. Esta solução é ideal para subscrições SaaS, serviços de adesão, doações recorrentes e cenários semelhantes.
Principais Vantagens:
- Uma única autorização do utilizador permite deduções periódicas automáticas pelo sistema—sem necessidade de ações repetidas por parte do utilizador
- Configuração flexível para períodos de teste e preços introdutórios, reduzindo as barreiras de conversão para os utilizadores
- Repetição automática em caso de falha na dedução, reduzindo a perda de encomendas
- Suporta quatro grandes redes EVM: Ethereum, Arbitrum, Polygon e BSC
Processo de Integração
Documentação da API: https://docs.gate.com/api-reference/version/100/en/endpoint/subscription/productCreate
Passo 1: Criar Informação do Produto
Crie o seu produto através da API, fornecendo detalhes como nome do produto, descrição, imagens, entre outros.
Passo 2: Criar Plano de Preços
Crie planos de preços para o seu produto, com os seguintes parâmetros configuráveis:
| Parâmetro | Descrição |
|---|---|
| Valor da Dedução | Valor por dedução, mínimo 0,01 |
| Moeda da Dedução | USDT ou USDC |
| Ciclo de Dedução | Diário / Semanal / Mensal / Anual, suporta intervalos personalizados de dias |
| Preço Introdutório (Opcional) | Suporta valor fixo ou taxa de desconto, aplicado apenas à primeira dedução |
| Período de Teste Gratuito (Opcional) | Defina dias de teste; não há deduções durante o período de teste |
Nota:
FIX_AMOUNT: Dedução de valor fixo—o sistema deduz automaticamente um valor fixo em cada ciclo
ACCOUNT_AUTH: Pagamento autorizado—o utilizador autoriza um determinado valor, e o comerciante pode deduzir qualquer montante dentro desse limite
Passo 3: Criar Plano de Subscrição
Associe o seu produto a um plano de preços, defina o limite máximo de dedução autorizado pelo utilizador e gere um plano de subscrição.
Passo 4: Gerar e Distribuir Link de Subscrição
Utilize a API para criar uma ordem de subscrição para o utilizador e obter um link de pagamento da subscrição.
⚠️ O link de subscrição é válido por 24 horas. Envie o link ao seu utilizador dentro do período de validade. Se expirar, terá de gerar um novo link através da API.
Envie o link ao seu utilizador; após clicar, os utilizadores podem concluir a ligação da carteira, autorizar o limite de dedução e efetuar o primeiro pagamento de forma autónoma.
Passo 5: Receber Notificações de Dedução
Após configurar o URL de callback, o sistema irá notificá-lo proativamente quando ocorrerem os seguintes eventos:
- O utilizador conclui a autorização
- A primeira dedução é bem-sucedida
- Cada dedução periódica é bem-sucedida ou falha
Explicação das Regras Principais
Horário das Deduções
O sistema processa as deduções periódicas em lotes todos os dias às 09:00, Hora de Pequim (UTC 01:00).
Regras de Disparo da Primeira Dedução
- Sem período de teste: A primeira dedução é efetuada imediatamente após a autorização do utilizador
- Com período de teste: O utilizador entra no período de teste após a autorização; a primeira dedução é automaticamente efetuada após o fim do teste
- Preço introdutório configurado: A primeira dedução utiliza o preço introdutório; as deduções seguintes usam o preço normal
Gestão de Falhas na Dedução
Se a dedução falhar devido a saldo insuficiente do utilizador ou limite autorizado:
- O sistema tenta novamente automaticamente a cada 6 horas, até 2 vezes
- Se todas as tentativas falharem, a ordem de subscrição é automaticamente fechada
- Para retomar, terá de gerar um novo link de subscrição para o utilizador
Explicação dos Estados da Ordem
td {white-space:nowrap;border:0.5pt solid #dee0e3;font-size:10pt;font-style:normal;font-weight:normal;vertical-align:middle;word-break:normal;word-wrap:normal;}
| Estado | Significado |
|---|---|
| Pending Authorization | Ordem criada, a aguardar autorização do utilizador |
| Authorized | Utilizador autorizou, a aguardar a primeira dedução |
| In Trial | Utilizador em período de teste, ainda sem dedução |
| Confirming | Primeira dedução em processamento (quando não há período de teste) |
| Active | Dedução automática periódica a decorrer normalmente |
| Completed | Subscrição termina normalmente após atingir o total de ciclos definidos ou a data final |
| Canceled | Comerciante cancela proativamente a subscrição |
| Unpaid | Dedução falhou, a aguardar nova tentativa do sistema |
| Closed | Limite de tentativas atingido, subscrição fechada |
| Intercepted | Transação on-chain bem-sucedida, mas validação de controlo de risco KYT falhou |
Consulta & Gestão de Ordens
Pode consultar os registos de dedução através dos seguintes métodos:
Painel do Comerciante: Inicie sessão no painel do comerciante → Ordens de Pagamento → Filtre pelo tipo de ordem “Pagamento por Subscrição”
API: Consulte detalhes da ordem de subscrição através do endpoint /open/v1/order/detail.
https://docs.gate.com/api-reference/version/100/en/endpoint/subscription/deductionOrderDetail
Exibição da Interface de Subscrição
Notas
- Atualmente, não é suportada a edição de planos de subscrição existentes (valor, ciclo, etc.). Para efetuar alterações, crie um novo plano de subscrição.
- A estrutura de taxas é consistente com a solução de pagamento Web3 já existente do Gate Pay. Tarifas dedicadas para pagamentos por subscrição serão introduzidas em versões futuras.
- Os utilizadores são responsáveis pelas taxas de gas durante a autorização; as taxas de gas de cada dedução automática são suportadas pela plataforma.
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.
