Integração com PayPal permite receber doações e vendas de itens VIP automaticamente no servidor de Tibia. Este guia mostra como configurar PayPal corretamente.
Configuração da conta PayPal #
Primeiro, você precisa de uma conta PayPal Business (não pessoal) para acessar APIs e receber pagamentos. Crie ou faça upgrade da conta no site do PayPal. Após criar a conta, acesse o PayPal Developer Dashboard e crie uma aplicação para obter Client ID e Secret. Escolha entre ambiente Sandbox (para testes) e Live (produção). Durante desenvolvimento, use Sandbox para testar sem risco. Configure URLs de retorno e cancelamento que o PayPal usará após processar pagamentos.
Escolhendo método de integração #
PayPal oferece vários métodos: PayPal Buttons (mais simples, mas menos controle), PayPal SDK (mais flexível), ou PayPal REST API (máximo controle). Para servidores de Tibia, recomendamos PayPal SDK ou REST API para ter controle total sobre o processo e poder integrar com sistema de entrega automática. A REST API permite criar pagamentos, processar aprovações, e verificar status de transações programaticamente.
Implementação do sistema de pagamento #
Crie uma página no site onde jogadores podem escolher pacotes de doação (ex.: 10 pontos por R$ 5,00, 25 pontos por R$ 10,00). Ao clicar em “Comprar”, redirecione o jogador para o PayPal usando a API. Após o pagamento ser aprovado, PayPal redireciona de volta para sua URL de retorno com um token de autorização. Use este token para capturar o pagamento e obter confirmação final. Valide o pagamento consultando a API do PayPal antes de entregar os itens.
Sistema de notificações (IPN) #
Configure Instant Payment Notification (IPN) do PayPal para receber notificações automáticas quando pagamentos são processados. Isso é crucial porque jogadores podem fechar o navegador antes de retornar à sua página de retorno. O IPN envia requisição POST para uma URL que você especifica sempre que há mudança no status de uma transação. Crie um endpoint que recebe essas notificações, valida que realmente vieram do PayPal (usando verificação de assinatura), e processa a entrega dos itens automaticamente.
Entrega automática de itens #
Após validar o pagamento (via retorno ou IPN), atualize o banco de dados do servidor de Tibia para adicionar pontos, ativar VIP, ou entregar itens. Crie uma tabela de transações para rastrear todos os pagamentos, incluindo status, valor, e o que foi entregue. Implemente sistema de retry caso a entrega falhe na primeira tentativa. Envie e-mail de confirmação ao jogador informando o que foi adquirido. Considere adicionar sistema de log detalhado para auditoria e troubleshooting.
Segurança e validação #
Sempre valide pagamentos consultando a API do PayPal antes de entregar itens. Nunca confie apenas em dados enviados pelo navegador do jogador. Use HTTPS para todas as comunicações. Implemente verificação de assinatura em notificações IPN para garantir que realmente vieram do PayPal. Adicione rate limiting para prevenir abuso. Monitore transações suspeitas (mesmo valor múltiplas vezes, valores muito altos, etc.) e implemente sistema de alertas.
Tratamento de erros e reembolsos #
Implemente tratamento robusto de erros: se o pagamento foi processado mas a entrega falhou, registre o erro e tente novamente automaticamente. Se múltiplas tentativas falharem, notifique o administrador. Crie processo para lidar com reembolsos: se um jogador solicitar reembolso e você aprovar, remova os itens/benefícios entregues antes de processar o reembolso via API do PayPal. Documente claramente política de reembolsos para jogadores.
FAQ #
Quanto custa usar PayPal? #
PayPal cobra taxa por transação (geralmente 3-4% + taxa fixa por país). Verifique taxas atualizadas no site do PayPal para sua região.
Posso testar sem processar pagamentos reais? #
Sim, use PayPal Sandbox que permite criar contas e cartões de teste para simular pagamentos completos sem custo.
E se o jogador não retornar após pagar? #
É por isso que IPN é essencial. Mesmo se o jogador fechar o navegador, você receberá notificação e poderá entregar os itens automaticamente.
Com PayPal integrado corretamente, você oferece sistema de pagamento profissional e confiável para o servidor de Tibia.
