Uma seleção de artigos, bibliotecas e recursos úteis sobre a Open API do M-Pesa em Moçambique.
- O que é a Open API do M-Pesa?
- Como posso integrar?
- Processo
- Recursos
- Bibliotecas
- Artigos
- Vídeos
- Regulamentação
- Exemplo de E-mail de Solicitação
- Como contribuir
A Open API do M-Pesa é um conjunto de interfaces programáveis (APIs) disponibilizadas pela Vodacom Moçambique que permite a integração de aplicações, sistemas ou plataformas com os serviços financeiros digitais do M-Pesa.
O objetivo principal da Open API é permitir que empresas, desenvolvedores e instituições automatizem operações financeiras, como:
- Colecta de pagamentos (cobrança)
- Envio de fundos para clientes ou fornecedores
- Consultas de transações
- Estornos (reversões) de pagamentos
- Validação de contas
A integração pode ser feita de dois modos:
- Directo, onde o desenvolvedor faz a intelergicação diretamente com a API do M-Pesa, utilizando as credenciais fornecidas pela Vodacom Moçambique.
- Usando um agregador, que é uma empresa ou serviço que já possui integração com a API do M-Pesa e oferece uma interface simplificada para desenvolvedores.
O processo para a integração directa está descrito abaixo na secção Processo.
Em linhas gerais o processo de integração com a API Publica do M-Pesa envolve as seguintes etapas principais:
- Criação de Conta e Integração no Ambiente de Desenvolvimento
A primeira etapa consiste em criar uma conta no portal de desenvolvedores do M-Pesa, disponível em: https://developer.mpesa.vm.co.mz. Após o registo, será possível integrar o seu sistema ao ambiente de desenvolvimento, onde poderá testar todas as operações suportadas (cobrança, estorno, consulta, etc.). Neste ambiente, também terá acesso às API keys necessárias para a configuração e testes iniciais.
- Validação e Pedido de Acesso ao Ambiente de Produção
Assim que os testes forem concluídos com sucesso, deverá contactar a equipa do M-Pesa através do email: M-Pesa.business@vm.co.mz solicitando a migração para o ambiente de produção. Neste ponto, será necessário cumprir com determinados requisitos legais, que variam conforme o tipo de entidade (pessoa singular, empresa, organização, etc.). Os detalhes estão disponíveis no ficheiro de requisitos legais fornecido na secção de recursos.
- Formalização do Acordo e Treinamento
Em colaboração com a equipa do M-Pesa, deverá:
- Enviar a documentação exigida;
- Negociar as comissões aplicáveis;
- Assinar o contrato de prestação de serviços;
- Proceder à abertura de uma conta empresa no M-Pesa;
- Participar numa formação sobre a gestão da conta e utilização do sistema, incluindo: gestão de utilizadores, reversões de transações, análise de relatórios, entre outros aspetos operacionais do backoffice.
- Integração no Ambiente de Produção
Após a conclusão das etapas anteriores, será fornecido o acesso às API keys do ambiente de produção. Com estas credenciais, poderá configurar o seu sistema para iniciar as operações reais.
- Início das Operações Comerciais
Com a integração finalizada e os acessos configurados, poderá começar a explorar e operar com a plataforma de pagamentos M-Pesa de forma plena.
- Descrição do serviço da Open API do M-Pesa - Documentação oficial do serviço.
- Portal do Desenvolvedor M-Pesa - Portal oficial para desenvolvedores.
- Requisitos de Acesso à API de Produção e Checklist - Documento oficial com requisitos e checklist para acesso à API.
- mpesasdk - SDK não oficial para facilitar a integração com a API de pagamentos da Vodacom Moçambique em aplicativos Android.
- mpesa-node-api - Biblioteca Node.js para a API do M-Pesa (Moçambique).
- mpesa-php-api - Biblioteca PHP para a API do M-Pesa (Moçambique).
- mpesa_sdk_dart - Biblioteca Dart | Flutter para a API do M-Pesa (Moçambique).
- mpesa-sdk-ios - Biblioteca Swift | iOS para a API do M-Pesa (Moçambique).
- mpesa-wordpress-plugin - Plugin de pagamento Vodacom M-PESA para WooCommerce em Moçambique.
- wc-mpesa-payment-gateway - Gateway de Pagamento Vodacom M-Pesa para WooCommerce.
- karson/mpesa-php-sdk - SDK PHP para as APIs RESTful do Vodacom M-Pesa em Moçambique.
- paymentsds - Conjunto de SDKs para integração de operações do M-Pesa em aplicativos.
- mpesa-sdk-rust - Biblioteca Rust para interagir com a API do M-Pesa, simplificando integrações de pagamento B2C.
- Mpesa, mais do que uma API… - Artigo descrevendo o processo de integração, desde a criação da conta até a produção.
- Um olhar sobre a API do M-Pesa - Visão geral da API do ponto de vista do desenvolvedor.
- Decreto 59/2023 - destaques & implicações - Análise do decreto e suas implicações.
- Implementar Mpesa em Android (Dario Mungoi mpesaSDK) - Tutorial de implementação do M-Pesa em aplicativos Android.
- Lei das Transações Eletrônicas - Documento oficial da lei.
- Regulamento de Registro e Licenciamento BR_206_I_SERIE_2023 - Regulamento oficial de registro e licenciamento.
Para: M-Pesa.business@vm.co.mz
Assunto: Acesso à Open API para {Nome da Empresa}
De: Responsável pelo Negócio
Corpo:
Saudações, equipe M-Pesa,
Espero que este e-mail os encontre bem. Meu nome é {Seu Nome} e estou entrando em contato como responsável pelo negócio para solicitar formalmente o acesso à Open API.
Em anexo, envio todos os documentos necessários especificados no Checklist fornecido. Certifiquei-me de incluir todas as informações exigidas para sua análise.
Aguardo instruções sobre os próximos passos do processo.
Obrigado pela atenção e retorno rápido.
Atenciosamente,Por favor, leia o guia de contribuição.