O 360Pay permite que os seus alunos paguem cursos do MasterStudy LMS com a carteira móvel, no próprio checkout do site. O aluno escolhe a carteira, escreve o número de telefone e confirma o pagamento no telemóvel. Assim que a carteira confirma, o acesso ao curso é libertado automaticamente.
Foi pensado para escolas, formadores e plataformas de ensino em Moçambique.
Principais funcionalidades
- Checkout nativo do MasterStudy – não precisa do WooCommerce. As encomendas são criadas no próprio MasterStudy.
- Várias carteiras móveis – M-Pesa (Vodacom) já incluída. e-Mola, mKesh ou outra carteira com API podem ser configuradas manualmente.
- Pagamento confirmado no servidor – a encomenda fica pendente até a API da carteira confirmar o pagamento. Referência, valor, moeda, aluno, curso e estado são validados antes de libertar o acesso.
- Matrícula automática – o aluno é inscrito no curso logo após a confirmação.
- Confirmação por callback e verificação automática – recebe as notificações da carteira através da REST API e, se alguma falhar, verifica o estado sozinho através do WP-Cron.
- Faturas em PDF – emissão automática de fatura com os dados da sua empresa (NUIT, endereço, logótipo e assinatura) e envio por e-mail ao aluno.
- Painel de gestão completo – transações com filtros, pesquisa, paginação e exportação para CSV, registos técnicos e página de diagnóstico.
- Seguro por defeito – o site nunca pede o PIN nem códigos da carteira; chaves e dados sensíveis aparecem mascarados no painel e nos registos.
Como funciona
- O aluno escolhe “Carteiras móveis” no checkout e seleciona a sua carteira.
- Escreve o número de telefone associado à carteira.
- Recebe no telemóvel o pedido de pagamento e confirma com o PIN, na própria carteira.
- O 360Pay recebe a confirmação, conclui a encomenda e inscreve o aluno no curso.
Aviso legal
Este é um plugin independente, desenvolvido pela Agência +360º. Não é afiliado, aprovado nem patrocinado pela MasterStudy LMS / StylemixThemes nem pela Vodacom / M-Pesa. “MasterStudy” e “M-Pesa” são marcas dos respetivos proprietários e são usadas aqui apenas para identificar os serviços com que o plugin se integra.
Serviços externos
Para iniciar e confirmar pagamentos, o plugin comunica com as APIs das carteiras móveis. Dados de cartão, PIN ou códigos de confirmação nunca passam pelo site.
1. API M-Pesa da Vodacom Moçambique (carteira incluída)
- O que é e para que serve: a plataforma oficial de pagamentos M-Pesa da Vodacom Moçambique. É usada para enviar o pedido de pagamento C2B (Cliente para Empresa) para o telemóvel do aluno e para confirmar o estado da transação, de modo a libertar o curso apenas depois de o pagamento ser confirmado no servidor.
- Que dados são enviados e quando: o número de telefone do cliente (MSISDN), o valor, a moeda e uma referência única da transação. São enviados (a) quando o aluno clica em “Pagar” no checkout e (b) depois, nas verificações automáticas do estado do pagamento (WP-Cron).
- Endereços utilizados: https://api.vm.co.mz:18352 (produção) e https://api.sandbox.vm.co.mz:18352 (testes) para o pedido de pagamento; https://api.vm.co.mz:18353 e https://api.sandbox.vm.co.mz:18353 para a consulta do estado da transação.
- Termos e condições: https://www.vm.co.mz/artigo/termos-e-condicoes
- Política de privacidade: https://www.vm.co.mz/privacidade
- Portal de programadores: https://developer.mpesa.vm.co.mz/
2. Outras carteiras configuradas pelo administrador (opcional)
- O que é e para que serve: o plugin só comunica com outras carteiras (por exemplo e-Mola, mKesh ou uma carteira personalizada) se o administrador do site as ativar e configurar, indicando os endereços e as credenciais do fornecedor. São usadas para o mesmo fim: pedir o pagamento e confirmar o seu estado.
- Que dados são enviados e quando: os mesmos dados (telefone, valor, moeda e referência), enviados ao endereço configurado pelo administrador, nos mesmos momentos descritos acima.
- Termos e privacidade: dependem do fornecedor escolhido. O administrador é responsável por ler e cumprir os termos e a política de privacidade desse fornecedor antes de o ativar.
Para programadores
Endpoints REST:
- Callback da carteira:
/wp-json/ms-wallet-payments/v1/callback/{wallet_slug}
- Estado de uma transação:
/wp-json/ms-wallet-payments/v1/status/{transaction_reference}
- Reprocessar callback (apenas administradores):
/wp-json/ms-wallet-payments/v1/reprocess/{transaction_reference}
- Iniciar pagamento:
/wp-json/ms-wallet-payments/v1/start
- Carteiras ativas:
/wp-json/ms-wallet-payments/v1/wallets
Filtros disponíveis para adaptar o checkout, a criação e conclusão da encomenda e a matrícula:
mswp_masterstudy_checkout_context
mswp_masterstudy_create_pending_order
mswp_masterstudy_complete_order
mswp_masterstudy_enroll_user
mswp_masterstudy_mark_order_not_paid
mswp_admin_parent_slug – coloca o menu do 360Pay dentro de outro menu (por exemplo o do MasterStudy).
Shortcodes de recurso, para testes:
[mswp_wallet_checkout course_id="123" amount="1500" currency="MZN"] – botão de pagamento.
[mswp_payment_status] – estado do pagamento.
Créditos
- Fonte Manrope – SIL Open Font License 1.1.
- Ícones baseados no Lucide (https://lucide.dev) – licença ISC.