Configurações do DonatePay

Vem com o strAImer: este módulo é instalado junto com o aplicativo, então não há nada para baixar. Ele aparece em Catálogo de Módulos → Integrados.

O que é esta página

Conexões → Monetização → DonatePay é onde se fornece um token de API ao DonatePay para que as doações cheguem ao aplicativo. Duas coisas estão aqui: o interruptor Aceitar doações e o próprio token.

Como configurar

1. Abra Conexões → Monetização e pressione Conectar DonatePay no cartão. Em um cartão já conectado, a mesma página abre com Configurar. A seta no canto superior esquerdo, Voltar, regressa à lista.
2. A página tem o título Configurações do DonatePay, com "Configure a integração com o DonatePay para receber notificações de doações." embaixo.
3. A linha superior é Aceitar doações, com o subtítulo DonatePay, um indicador e um interruptor. O interruptor atua no momento em que o liga — não está esperando o botão de salvar. Com ele desligado, o indicador mostra Desativado e nada é recebido.
4. Pressione Abrir a página de API do DonatePay. Abre donatepay.ru no seu navegador normal. A dica diz o que esperar: "O DonatePay emite o token na sua página da API — só abre depois de entrar."
5. Copie o token dessa página e cole-o em Token de Acesso à API. O campo esconde o que escreve; enquanto está vazio, pede "Insira o Token da API (disponível no painel do DonatePay)".
6. Pressione Salvar Configurações no canto superior direito. Ele dá feedback — Salvando…, depois Salvo, ou Erro se o token não foi armazenado. Após salvar com sucesso, a página se fecha e regressa à lista de serviços.
7. Salvar com o campo vazio e sem token armazenado ainda é recusado com "Por favor, insira o seu token da API."
8. Reabra a página para verificar. O campo do token está vazio de propósito — um token armazenado nunca é mostrado. Que ele existe é indicado pela mensagem dentro do campo: "Token salvo — deixe em branco para mantê-lo". Deixar o campo vazio e pressionar Salvar Configurações mantém o token armazenado inalterado; para substituí-lo, escreva o novo por cima.
9. O indicador ao lado do interruptor informa sobre o estado da conexão: Não conectado (ainda sem token), Desativado (o interruptor está desligado), Conectando…, Novo token necessário, Erro de conexão, ou Conectado como {nome de usuário}. Ele se atualiza sozinho a cada poucos segundos enquanto a página está aberta.
10. Novo token necessário significa que o token armazenado já não funciona. Obtenha um novo na página de API do DonatePay e salve-o por cima do antigo.

Uma recusa não é tomada como definitiva na hora. Se o DonatePay já aceitou esse token antes, o app responde à recusa com uma pausa e uma nova tentativa: 5 segundos, depois 10, 20 e assim por diante, até cinco minutos. O indicador mostra Erro de conexão a partir da terceira recusa seguida, e Novo token necessário só depois que as recusas duram dez minutos sem nenhuma resposta aceita (dois minutos logo depois de iniciar ou salvar). Mesmo assim o token é testado de novo a cada cinco minutos, e o indicador volta ao normal sozinho assim que o DonatePay o aceitar. Um token que o DonatePay nunca aceitou pede uma troca na hora.

O que não pode fazer

• O token não pode ser lido de volta a partir do aplicativo — o campo não mostra nada, e não há controle para revelar.
• Não há login no navegador aqui: o token é copiado manualmente. O botão apenas abre a página do DonatePay, não obtém nada.
• O nome da conta não é digitado. O aplicativo pede o nome ao DonatePay assim que o token é aceito, então ele aparece junto com a conexão e nenhuma doação é necessária. Se o DonatePay não informar um nome, o indicador e o cartão mostram DonatePay User no lugar.
• O interruptor apenas governa se o DonatePay é aceito. Não é o ligar/desligar do módulo no catálogo, e não desconecta mais nada.
• Desconectar e Remover conexão (o ícone da lixeira) estão no cartão do DonatePay em Conexões → Monetização, não nesta página.
• Nenhuma doação, valor ou histórico é mostrado aqui — esta página é apenas sobre acesso.