Visão Geral do Produto
Os Pagamentos por Assinatura do Gate Pay oferecem capacidades de débito automático em stablecoins baseadas em blockchain, permitindo que você cobre automaticamente USDT ou USDC de seus usuários em redes compatíveis com EVM, seguindo um cronograma definido. Essa solução é ideal para assinaturas SaaS, serviços de associação, doações recorrentes e cenários semelhantes.
Principais Vantagens:
- Autorização única do usuário permite que o sistema realize débitos periódicos automáticos—não é necessário repetir ações do usuário
- Configuração flexível para períodos de teste e preços introdutórios reduz barreiras de conversão para os usuários
- Nova tentativa automática em caso de falha no débito reduz a perda de pedidos
- Suporte às quatro principais 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ções do Produto
Crie seu produto via API, fornecendo detalhes como nome do produto, descrição, imagens e mais.
Passo 2: Criar Plano de Preços
Crie planos de preços para seu produto, com os seguintes parâmetros configuráveis:
| Parâmetro | Descrição |
|---|---|
| Valor do Débito | Valor por débito, mínimo 0,01 |
| Moeda do Débito | USDT ou USDC |
| Ciclo do Débito | Diário / Semanal / Mensal / Anual, com suporte a intervalos personalizados de dias |
| Preço Introdutório (Opcional) | Suporta valor fixo ou taxa de desconto, aplicado apenas ao primeiro débito |
| Período de Teste Gratuito (Opcional) | Defina dias de teste; nenhum débito durante o período de teste |
Observação:
FIX_AMOUNT: Débito de valor fixo—o sistema deduz automaticamente um valor fixo a cada ciclo
ACCOUNT_AUTH: Pagamento autorizado—o usuário autoriza um valor, e o comerciante pode debitar qualquer valor dentro desse limite
Passo 3: Criar Plano de Assinatura
Associe seu produto a um plano de preços, defina o limite máximo de débito autorizado pelo usuário e gere um plano de assinatura.
Passo 4: Gerar e Distribuir o Link de Assinatura
Use a API para criar um pedido de assinatura para o usuário e obtenha um link de pagamento por assinatura.
⚠️ O link de assinatura é válido por 24 horas. Envie o link ao seu usuário dentro do período de validade. Se expirar, será necessário gerar um novo link via API.
Envie o link ao usuário; após clicar, ele poderá conectar a carteira, autorizar o limite de débito e realizar o primeiro pagamento por conta própria.
Passo 5: Receber Notificações de Débito
Após configurar a URL de callback, o sistema notificará você proativamente quando ocorrerem os seguintes eventos:
- Usuário conclui a autorização
- Primeiro débito realizado com sucesso
- Cada débito periódico realizado com sucesso ou falha
Explicação das Regras Principais
Horário dos Débitos
O sistema processa os débitos periódicos em lotes todos os dias às 09:00, horário de Pequim (UTC 01:00).
Regras de Gatilho para o Primeiro Débito
- Sem período de teste: O primeiro débito é realizado imediatamente após a autorização do usuário
- Com período de teste: O usuário entra no período de teste após a autorização; o primeiro débito é realizado automaticamente após o término do teste
- Preço introdutório configurado: O primeiro débito utiliza o preço introdutório; os próximos usam o preço regular
Tratamento de Falhas no Débito
Se o débito falhar por saldo insuficiente ou limite autorizado insuficiente do usuário:
- O sistema tenta novamente automaticamente a cada 6 horas, até 2 vezes
- Se todas as tentativas falharem, o pedido de assinatura é encerrado automaticamente
- Para retomar, é necessário gerar um novo link de assinatura para o usuário
Explicação dos Status dos Pedidos
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;}
| Status | Significado |
|---|---|
| Pending Authorization | Pedido criado, aguardando autorização do usuário |
| Authorized | Usuário autorizou, aguardando o primeiro débito |
| In Trial | Usuário está em período de teste, ainda sem débito |
| Confirming | Processando o primeiro débito (quando não há período de teste) |
| Active | Débito automático periódico em funcionamento normal |
| Completed | Assinatura encerrada normalmente após atingir o total de ciclos ou data final definida |
| Canceled | Comerciante cancelou a assinatura de forma proativa |
| Unpaid | Débito falhou, aguardando nova tentativa do sistema |
| Closed | Limite de tentativas atingido, assinatura encerrada |
| Intercepted | Transação on-chain bem-sucedida, mas validação de risco KYT falhou |
Consulta e Gerenciamento de Pedidos
Você pode consultar os registros de débito pelos seguintes métodos:
Painel do Comerciante: Faça login no painel do comerciante → Pedidos de Pagamento → Filtre pelo tipo de pedido “Pagamento por Assinatura”
API: Consulte detalhes do pedido de assinatura pelo endpoint /open/v1/order/detail.
https://docs.gate.com/api-reference/version/100/en/endpoint/subscription/deductionOrderDetail
Exibição da Interface de Assinatura
Observações
- Atualmente, não é possível editar planos de assinatura existentes (valor, ciclo, etc.). Para fazer alterações, crie um novo plano de assinatura.
- A estrutura de taxas é a mesma da solução de pagamento Web3 do Gate Pay. Tarifas dedicadas para pagamentos por assinatura serão lançadas em versões futuras.
- Os usuários são responsáveis pelas taxas de gas durante a autorização; as taxas de gas de cada débito automático são cobertas pela plataforma.
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.
