Sistema de Pagamentos

Visão Geral

O sistema de pagamentos da aplicação UNICEF Portugal foi desenvolvido para suportar dois métodos de pagamento:

• EasyPay — Gateway de pagamento português (método principal)
• PayPal — Método alternativo para pagamentos internacionais

Sistema Inativo desde Maio de 2020

A análise à base de dados de pagamentos confirma que o último registo de encomenda data de 18 de maio de 2020 — há mais de 6 anos. O processamento de donativos foi entretanto migrado para fora do website Umbraco. No entanto, permanecem ativos no Umbraco:

• 4 páginas de donativo publicadas
• Formulários EasyPay e PayPal publicados
• Base de dados SQL "EasyPay" a correr (custo mensal estimado: ~15 EUR em produção + ~15 EUR em qualidade)
• Jobs Hangfire desativados (já não processam pagamentos)

Recomenda-se uma decisão formal sobre a desativação destes componentes.

Evidência de Inatividade

Dados obtidos da base de dados EasyPay (bacpac do repositório):

Tabela	Registos	Período de Atividade
Order	8.676	Agosto 2018 — Maio 2020
EasyPayPayment	6.453	Mesmo período
EasyPayRecurrentPayment	1.325	Mesmo período
EasyPayPaymentRequest	1.166	Mesmo período
OrderHistory	919	Mesmo período

Nota

Estes dados são do ficheiro .bacpac existente no repositório e podem não refletir o estado atual da base de dados de produção. Recomenda-se verificar diretamente na base de dados EasyPay de produção (uncsqlsrv-prd.database.windows.net) se existem registos mais recentes.

Arquitetura

graph TB subgraph Frontend A["Pagina de Donativo - donationPage"] end subgraph Backend B["PaymentsManager"] C["DAL.Payments"] end subgraph Gateways D["EasyPay - easypay.pt"] E["PayPal - paypal.com"] end subgraph BD F[("EasyPay - SQL Server separada")] end A --> B B --> C B --> D B --> E C --> F style A fill:#ffcdd2,stroke:#c62828 style D fill:#ffcdd2,stroke:#c62828 style E fill:#ffcdd2,stroke:#c62828 style F fill:#ffcdd2,stroke:#c62828

Diagrama: Os componentes a vermelho estão potencialmente obsoletos.

Projetos no Código

Projeto	Descrição	Estado
PaymentsManager (PaymentsManager.csproj)	Lógica de processamento de pagamentos. Comunicação com EasyPay e PayPal	Inativo
DAL.Payments (DAL.Payments.csproj)	Camada de acesso a dados para pagamentos	Inativo
Business.PaymentGateway.Paypal	Integração com PayPal	Inativo
Test.Payment.EasyPay	Testes de pagamento EasyPay	Inativo
Test.Payments	Testes gerais de pagamentos	Inativo

Base de Dados de Pagamentos

Os dados de pagamentos estão armazenados numa base de dados SQL Server separada chamada "EasyPay", alojada no mesmo servidor Azure SQL (uncsqlsrv-prd).

Tabelas

Tabela	Registos	Descrição
Order	8.676	Encomendas/donativos
EasyPayPayment	6.453	Pagamentos confirmados via EasyPay
EasyPayRecurrentPayment	1.325	Pagamentos recorrentes
EasyPayPaymentRequest	1.166	Pedidos de pagamento enviados ao EasyPay
OrderHistory	919	Histórico de encomendas
EasyPayRecurrentPaymentRequest	44	Pedidos de pagamentos recorrentes
EasyPayRecurringNotification	2	Notificações de pagamentos recorrentes
EasyPayNotification	2	Notificações recebidas do EasyPay

Stored Procedures

Procedimento	Descrição
UpdateOrder	Atualiza o estado de uma encomenda
UpdatePayment	Atualiza o estado de um pagamento
UpdatePaymentProcessed	Marca pagamento como processado
UpdateRecurrentPayment	Atualiza pagamento recorrente
UpdateNumberOfDebits	Atualiza contador de débitos
UpdateEasyPayNotification	Regista notificação recebida

Jobs Hangfire (DESATIVADOS)

O Hangfire era utilizado para processar pagamentos recorrentes, mas foi desativado devido a problemas de memória (commit a37e63e8). Dado que os pagamentos estão inativos desde 2020, a reativação do Hangfire não é necessária.

Job	Frequência Original	Descrição
ClearOldRecurringPayments()	Diário à meia-noite	Limpeza de pagamentos recorrentes antigos
ProcessDailyRecurringPayments("1M")	Diário	Pagamentos recorrentes mensais
ProcessDailyRecurringPayments("6M")	Diário	Pagamentos recorrentes semestrais
ProcessDailyRecurringPayments("1Y")	Diário	Pagamentos recorrentes anuais

Custos Associados

Recurso	Ambiente	SKU	Custo Estimado/Mês
Base de dados EasyPay	Produção	Standard S0 (10 DTU)	~15 EUR
Base de dados EasyPay-qual	Qualidade	Standard S0 (10 DTU)	~15 EUR
Total			~30 EUR/mês

Nota sobre Custos

Os valores são estimativas indicativas. Consultar o Azure Cost Management para obter os custos reais.

Plano de Desativação Proposto

Caso a equipa UNICEF confirme que os pagamentos são processados fora do website Umbraco:

flowchart TD A["1. Confirmar com UNICEF\nque pagamentos sao externos"] --> B{"Confirmado?"} B -->|Sim| C["2. Exportar backup final\nda BD EasyPay"] B -->|Nao| Z["Manter ativo\ne documentar"] C --> D["3. Despublicar paginas\nde donativo no Umbraco"] D --> E["4. Remover connection string\nEasyPay do Web.config"] E --> F["5. Eliminar BD EasyPay-qual"] F --> G["6. Monitorizar 30 dias"] G --> H["7. Eliminar BD EasyPay\nem producao"] H --> I["Poupanca: ~30 EUR/mes"]

Passos Detalhados

1. Confirmar com a UNICEF que os donativos são atualmente processados por uma plataforma externa (e qual)
2. Exportar um backup final da base de dados EasyPay de produção para armazenamento (blob storage ou local)
3. Despublicar as 4 páginas de donativo no backoffice Umbraco, bem como os formulários EasyPay e PayPal
4. Remover a connection string "Payments" do Web.config (e transforms)
5. Eliminar a base de dados EasyPay-qual em qualidade (ambiente de testes)
6. Monitorizar durante 30 dias para garantir que nada depende destas bases de dados
7. Eliminar a base de dados EasyPay em produção
8. Numa fase posterior, remover o código dos projetos PaymentsManager, DAL.Payments e testes associados

Código Legacy

A remoção do código de pagamentos (PaymentsManager, DAL.Payments, etc.) pode ser feita numa fase posterior, uma vez que o código inativo não consome recursos nem afeta a performance. A prioridade deve ser a eliminação das bases de dados para reduzir custos imediatos.