O que precisa antes de começar
Precisa de uma conta de comerciante verificada e do número de telemóvel do negócio. Na pay.co.mz, o registo pede documento de identificação (frente e verso) e NUIT; a verificação fica pendente até aprovação e só depois é que a conta passa a movimentar dinheiro real.
Opção 1 — sem escrever código
Crie um link de pagamento no painel, com descrição e valor, e partilhe por WhatsApp, Facebook ou SMS. O cliente abre o link, escolhe M-Pesa, introduz o número, confirma com o PIN e o pagamento aparece no seu painel. É a via mais rápida para barracas, restaurantes, serviços e vendas por redes sociais.
Opção 2 — integração por API
Com a API cria a cobrança a partir do seu sistema e recebe a confirmação por webhook. O fluxo típico é: criar a cobrança com método m-pesa, valor e contacto do cliente; mostrar ao cliente que deve confirmar no telemóvel; esperar o webhook de sucesso; libertar o pedido.
Erros comuns e como evitá-los
A maior parte das falhas não é técnica.
- Número inválido ou de outro operador — valide o prefixo antes de enviar.
- Saldo insuficiente na carteira do cliente — mostre uma mensagem clara e permita repetir.
- Cliente demora a confirmar — mantenha a cobrança pendente e não crie uma segunda.
- Pedido duplicado — use uma chave de idempotência por encomenda.
Conciliação ao fim do dia
Cada transacção fica registada com data, método, valor bruto, comissão de 10% e valor líquido. Exporte o período que quiser e compare com as suas encomendas. Como a liquidação é em tempo real, o saldo disponível reflecte o que já pode levantar.