Para programadores

API de pagamentos para Moçambique

Uma integração cobre os quatro métodos usados em Moçambique. Autentica com chave de API, Merchant ID, Wallet ID e URL base, e recebe webhooks assinados em cada mudança de estado.

API de pagamentos para Moçambique

O que a API faz

Cobrir o ciclo completo do dinheiro, sem painéis intermédios.

  • Criar cobranças por qualquer um dos quatro métodos.
  • Consultar o estado de uma transação pela referência PAY-XXXXX.
  • Receber webhooks assinados com HMAC-SHA256.
  • Gerar sessões de checkout para cartões.

Autenticação em quatro elementos

Cada pedido é validado com chave de API, Merchant ID de 10 dígitos, Wallet ID de 5 dígitos e URL base. Todas as chaves são geridas na área Developer e podem ser revogadas.

Boas práticas que aplicamos

A API foi desenhada para dinheiro real, não para demonstrações.

  • Idempotência por referência, para evitar cobranças duplicadas.
  • Estados terminais claros: pago, pendente, falhado.
  • Sem ambiente falso de sucesso — o resultado vem sempre do provedor.

Documentação

Os exemplos completos, campos e códigos de erro estão em /docs.

Perguntas frequentes

Que linguagens posso usar?
Qualquer uma que faça pedidos HTTP: PHP, Node.js, Python, Java, C# ou outras.
Como confirmo um pagamento no meu sistema?
Valide a assinatura do webhook e, em caso de dúvida, consulte o estado pela referência.
Existe ambiente de testes?
A integração M-Pesa é de produção. Para testar, use valores baixos em transações reais.

Continuar a ler

Read this page in English: /en/payments-api