Voltar ao blog

M-Pesa STK Push para cobrar rendas no Quénia: como funciona (guia do país)

Um guia para senhorios no Quénia. Deixe de esperar que os inquilinos se lembrem do seu número Paybill. O STK Push do M-Pesa envia um pedido de pagamento diretamente para o telemóvel deles: basta introduzir o PIN e a renda fica paga. Veja como funciona e como o configurar para os seus imóveis arrendados.

O que é o STK Push do M-Pesa?

O STK Push, abreviatura de SIM Toolkit Push, é uma funcionalidade do M-Pesa da Safaricom que permite a uma empresa iniciar um pedido de pagamento no telemóvel de um cliente. Em vez de o cliente percorrer manualmente os menus do M-Pesa, aparece-lhe no ecrã um pedido de pagamento para confirmar a transação com o PIN M-Pesa.

Se alguma vez pagou algo numa loja online ou numa aplicação e recebeu no telemóvel um pedido do M-Pesa do género «Introduza o PIN para pagar KES 2,500 à Empresa XYZ», já conhece o STK Push em ação.

Na cobrança de rendas, isto significa que, em vez de esperar que o inquilino se lembre de abrir o M-Pesa, introduzir o seu número Paybill, escrever o número de conta correto e indicar o montante certo, é o senhorio que envia um pedido que faz tudo isso por ele. O inquilino só tem de introduzir o PIN.

Quer o STK Push para os seus arrendamentos? O HomeManager funciona em toda a África; no Quénia, acrescenta o M-Pesa e o eTIMS. O STK Push vem incorporado e envia os pedidos automaticamente no dia da renda. Comece o período experimental gratuito →

Como funciona o STK Push do M-Pesa na cobrança de rendas (passo a passo)

Eis o fluxo técnico, explicado em linguagem simples:

Passo 1: o sistema envia o pedido

Na data de vencimento da renda (ou quando o senhorio o decidir manualmente), o sistema de gestão de imóveis envia um pedido à API Daraja da Safaricom. Esse pedido contém:

  • O número de telefone do inquilino
  • O montante a cobrar (a renda)
  • O shortcode da sua empresa (o número Paybill)
  • Uma referência de conta (por exemplo, o número da fração ou a identificação do inquilino)
  • Uma descrição que o inquilino verá (por exemplo, «Renda de julho - Fração 4B»)

Passo 2: o inquilino recebe o pedido

Em poucos segundos, aparece uma janela no telemóvel do inquilino:

Pedido de pagamento M-Pesa

Pagar KES 25,000 a [Nome da sua empresa]

Conta: Fração 4B - julho de 2026

Introduza o PIN M-Pesa para confirmar

O inquilino vê exatamente o que está a pagar, quanto e a quem. Sem ambiguidades.

Passo 3: o inquilino introduz o PIN (ou recusa)

O inquilino tem duas opções:

  • Introduzir o PIN: o pagamento é processado de imediato. O dinheiro passa da carteira M-Pesa dele para o seu Paybill.
  • Cancelar/ignorar: não é feito nenhum pagamento. O sistema regista a tentativa recusada.

Passo 4: confirmação e registo

Se o inquilino pagar:

  • A Safaricom envia ao sistema uma notificação (callback) a confirmar a transação
  • O sistema regista o pagamento na conta do inquilino
  • O saldo do inquilino é atualizado em tempo real
  • Pode ser gerado um recibo e enviado por SMS
  • O painel do senhorio mostra o pagamento de imediato

Todo o processo, do pedido à confirmação, demora menos de 30 segundos.

STK Push e Paybill tradicional: as principais diferenças

Os dois métodos usam a infraestrutura do Paybill do M-Pesa, mas a experiência é completamente diferente:

Fator Paybill tradicional STK Push
Quem inicia? O inquilino (tem de se lembrar e agir) O sistema (o pedido chega automaticamente)
Passos para o inquilino 5 a 6 passos (navegar nos menus, introduzir dados) 1 passo (introduzir o PIN)
Risco de erro Elevado (Paybill errado, número de conta errado, montante errado) Nulo (todos os dados já preenchidos)
Associação à conta Depende de o inquilino introduzir a referência correta Automática (o sistema define a referência)
Rapidez da cobrança Passiva: fica à espera Ativa: é o senhorio que desencadeia a cobrança
Reconciliação Exige associação manual (quem é «JOHN M»?) Automática: o sistema sabe que inquilino pagou

A mudança de fundo: com o Paybill tradicional, está numa posição passiva, à espera de que os inquilinos paguem corretamente. Com o STK Push, é o senhorio que desencadeia a cobrança e o sistema trata da associação. Para comparar o Paybill e o Till na cobrança de rendas, consulte o nosso guia detalhado.

Porque é que os senhorios precisam do STK Push para cobrar rendas

Se gere 10 ou mais frações arrendadas, eis porque é que o STK Push do M-Pesa muda as regras da cobrança de rendas:

1. Elimina os obstáculos ao pagamento

Cada passo de um processo de pagamento é um momento em que o inquilino pode adiar, enganar-se ou desistir. O Paybill tradicional tem 5 a 6 passos. O STK Push tem um: introduzir o PIN. Menos obstáculos significam pagamentos mais rápidos.

2. Elimina os erros no número de conta

Quantas vezes já recebeu um pagamento com a referência de conta errada? «RENDA» em vez de «4B». Ou o nome do inquilino em vez do número da fração. Com o STK Push, o sistema preenche automaticamente a referência de conta correta. Acabam-se os pagamentos por identificar parados no seu Paybill, sem forma de os associar.

3. Elimina os erros no montante

Às vezes os inquilinos pagam o montante errado: arredondam para baixo, esquecem-se da água ou pagam o valor do mês anterior depois de um aumento da renda. O STK Push envia o montante exato calculado, com todos os encargos desse mês.

4. Passa de uma cobrança passiva para uma cobrança ativa

Com os métodos tradicionais, toda a estratégia se resume a enviar um lembrete, esperar, enviar outro lembrete, esperar e, talvez, telefonar. Com o STK Push, pode desencadear a cobrança ativamente. O pedido chega ao telemóvel do inquilino no momento em que o senhorio (ou o sistema) decide cobrar. Combinado com lembretes de pagamento automáticos, encurta muito o ciclo de cobrança.

5. Reconciliação imediata

Como o sistema inicia o pagamento com um identificador próprio de cada inquilino, todos os pagamentos recebidos são associados automaticamente. Acabou-se percorrer extratos M-Pesa para tentar perceber quem pagou. O seu painel é atualizado em tempo real: Fração 4B paga, Fração 7A paga, Fração 2C ainda em dívida.

6. Funciona em qualquer telemóvel

O STK Push funciona tanto em smartphones como em telemóveis básicos (os antigos modelos ao estilo Nokia). O pedido usa o SIM Toolkit, que vem incorporado em todos os cartões SIM. O inquilino não precisa de smartphone, internet nem aplicação. Se tem M-Pesa, o STK Push funciona.

Problemas frequentes no pagamento de rendas que o STK Push resolve

«Esqueci-me do número Paybill»

Com o STK Push, o inquilino não precisa de saber nem de se lembrar de nenhum número Paybill. O pedido chega com tudo preenchido. Só tem de confirmar.

«Enviei para a conta errada»

As referências de conta mal escritas transformam a reconciliação num pesadelo. O STK Push elimina isto por completo: é o sistema que define a referência de conta, não o inquilino.

«Pago amanhã» (e depois esquece-se)

O pedido obriga a uma decisão imediata. Está no ecrã agora mesmo. Muitos inquilinos introduzem o PIN na hora, em vez de o fecharem e «se lembrarem mais tarde». O efeito psicológico de um pedido ativo, comparado com um lembrete passivo, é considerável.

«Paguei, mas não aparece»

Como os pagamentos são associados automaticamente, a confirmação é imediata. O inquilino recebe um recibo e o senhorio vê o pagamento de imediato. Acabam-se as dúvidas do tipo «será que passou?».

«Paguei o montante errado»

O montante exato vem indicado no pedido. Se a renda for KES 25,000 mais KES 1,200 de água, o pedido mostra KES 26,200. Sem adivinhações, sem arredondamentos.

Requisitos técnicos do STK Push

Se está a avaliar o STK Push para a sua cobrança de rendas, eis o que é necessário nos bastidores:

Acesso à API Daraja da Safaricom

O STK Push é implementado através da API Daraja da Safaricom (mais concretamente, a API «Lipa na M-Pesa Online»). Isto exige:

  • Um número Paybill ou Buy Goods registado na Safaricom
  • Uma aplicação Daraja API aprovada (registada no Safaricom Developer Portal)
  • Credenciais da API: Consumer Key, Consumer Secret e Passkey

Um servidor para receber as notificações (callbacks)

Quando um inquilino conclui (ou recusa) um pagamento, a Safaricom envia uma notificação (callback) para um URL indicado por si. Precisa de um servidor que:

  • Esteja acessível por HTTPS (ligação segura)
  • Consiga receber e processar pedidos POST da Safaricom
  • Registe o resultado da transação no inquilino correto

Camada de lógica de negócio

O sistema precisa de saber:

  • A que inquilinos cobrar
  • Quanto deve cada inquilino (incluindo encargos variáveis, como a água)
  • Quando enviar o STK Push (na data de vencimento ou a pedido)
  • O que fazer quando um pagamento é bem-sucedido ou falha

O que isto significa para os senhorios

Na prática: não basta «ligar» o STK Push. É preciso integração por API, um servidor e lógica de negócio. É aqui que entra o software de gestão de imóveis: trata de toda a complexidade técnica e oferece uma interface simples.

Opções de configuração: fazer por conta própria ou usar software de gestão de imóveis

Opção 1: construir a integração por conta própria

Se tem conhecimentos técnicos (ou um programador), pode construir diretamente a integração do STK Push:

  • Vantagens: controlo total, feito à medida das suas necessidades, sem mensalidade de software
  • Desvantagens: exige competências de programação e manutenção contínua; o servidor fica a seu cargo e a segurança é da sua responsabilidade
  • Custo: KES 50,000 a 200,000 pelo desenvolvimento inicial, mais alojamento e manutenção
  • Prazo: 2 a 8 semanas, conforme a complexidade

Faz sentido se for programador ou se tiver mais de 200 frações, com requisitos próprios que justifiquem o investimento.

Opção 2: usar um software de gestão de imóveis com o STK Push incorporado

O caminho mais rápido para a maioria dos senhorios: escolher um software que já tenha o STK Push integrado.

  • Vantagens: configuração imediata, sem conhecimentos técnicos, manutenção a cargo do fornecedor, inclui outras funcionalidades (faturação, relatórios, lembretes)
  • Desvantagens: mensalidade da subscrição, menos personalização
  • Custo: subscrição mensal do software (KES 7,500 a 45,000, conforme o número de frações)
  • Prazo: no próprio dia: crie a sua conta e comece a cobrar

Para 90% dos senhorios, esta é a escolha certa. O software trata da API, do servidor, das notificações, da lógica de associação: de tudo. O senhorio só vê «paga» ou «por pagar» no painel.

Como o HomeManager usa o STK Push para cobrar rendas

O HomeManager tem o STK Push do M-Pesa incorporado no centro do processo de cobrança de rendas. Eis como funciona na prática:

Pedidos de cobrança automáticos

O senhorio define quando são enviados os pedidos STK Push:

  • Na data de vencimento: os pedidos saem automaticamente na data de vencimento da renda
  • Depois de um lembrete: se um inquilino não tiver pago até uma certa data, é enviado um pedido
  • Envio manual: pode enviar um pedido a um inquilino específico a qualquer momento, a partir do painel

Cálculo inteligente do montante

O montante do STK Push não é só a renda base. O HomeManager calcula o total, incluindo:

  • Renda base
  • Encargos de água (a partir das leituras do contador)
  • Qualquer saldo em dívida de meses anteriores
  • Multas por atraso (se aplicável)

O inquilino recebe um pedido com o montante exato que deve, não uma aproximação.

Registo automático dos pagamentos

Quando um inquilino confirma o pagamento:

  • O pagamento é registado de imediato na conta dele
  • O saldo é atualizado em tempo real no seu painel
  • É gerado um recibo digital, que pode ser enviado por SMS
  • Se for um pagamento parcial, o saldo restante fica registado

Tratamento das recusas

Se um inquilino recusar ou ignorar o pedido:

  • O sistema regista a tentativa recusada
  • É enviado um lembrete por SMS
  • O inquilino pode continuar a pagar manualmente por Paybill (não é STK Push ou nada)
  • Vê no relatório de cobrança que inquilinos recusaram

Alternativa: o Paybill manual continua a funcionar

O STK Push é o principal meio de cobrança, mas os inquilinos podem sempre pagar também pelo Paybill tradicional. O HomeManager associa automaticamente os dois tipos de pagamento ao inquilino correto. Isto resolve casos particulares, como inquilinos que preferem pagar manualmente ou situações em que o telemóvel está desligado quando o pedido é enviado.

Automatize a cobrança de rendas com o STK Push

O HomeManager envia pedidos STK Push do M-Pesa aos seus inquilinos no dia da renda. Eles introduzem o PIN e o senhorio vê o pagamento de imediato. Acabou-se andar atrás dos inquilinos e as dores de cabeça da reconciliação. O HomeManager funciona em toda a África; no Quénia, acrescenta o M-Pesa e o eTIMS.

Planos desde KES 7,500/mês (Starter, até 20 frações) até KES 45,000/mês (Scale, até 500 frações). Período experimental gratuito de 30 dias em todos os planos.

Comece a cobrar com o STK Push

Limitações e casos particulares

O STK Push é poderoso, mas não é perfeito. Conhecer as limitações ajuda a contorná-las:

O telemóvel tem de estar ligado e com rede

O pedido STK Push exige que o telemóvel do inquilino esteja ligado e com ligação à rede da Safaricom no momento do envio. Se o telemóvel estiver desligado ou numa zona sem rede, o pedido não chega. Solução: o sistema pode tentar novamente mais tarde e o inquilino pode sempre pagar manualmente por Paybill.

O pedido expira

Os pedidos STK Push têm um tempo limite (normalmente 60 segundos). Se o inquilino não responder nesse intervalo, o pedido desaparece. Não fica guardado para mais tarde: desaparece de vez. O sistema pode enviar outro pedido, mas isso exige uma nova chamada à API.

Saldo M-Pesa insuficiente

Se o inquilino não tiver dinheiro suficiente na carteira M-Pesa, a transação falha. O sistema regista o motivo da falha e o senhorio fica a saber que o inquilino tentou, mas não conseguiu pagar. Esta informação é útil: mostra que ele tentou.

Limites diários do M-Pesa

O M-Pesa tem limites por transação (atualmente KES 150,000 por transação para utilizadores registados). Na maioria das rendas residenciais, isto não é um problema. Em imóveis comerciais com rendas mais altas, os inquilinos podem ter de fazer vários pagamentos.

Não garante o pagamento

Os pedidos STK Push podem ser recusados. Um inquilino que não queira pagar pode simplesmente cancelar o pedido. O STK Push reduz os obstáculos para quem quer pagar, mas não obriga quem não quer. Para os incumpridores crónicos, continuam a ser precisos procedimentos de acompanhamento; o software apenas os torna visíveis mais depressa.

Perguntas frequentes

O que é o STK Push do M-Pesa para cobrar rendas?

O STK Push do M-Pesa é uma funcionalidade em que o sistema de cobrança envia um pedido de pagamento diretamente para o telemóvel do inquilino. Em vez de navegar nos menus do M-Pesa, introduzir números Paybill e escrever referências de conta à mão, o inquilino recebe simplesmente uma janela com o montante e o destinatário e introduz o PIN M-Pesa para confirmar. Automatiza a cobrança de rendas ao eliminar os passos manuais que causam atrasos, erros e pagamentos esquecidos.

Como é que o STK Push reduz os atrasos no pagamento da renda?

O STK Push ataca as duas principais causas dos atrasos na renda: o esquecimento e os obstáculos. O pedido chega no momento certo (na data de vencimento ou quando é enviado) e só exige o PIN, sem ter de se lembrar de números Paybill nem de referências de conta. Estudos de empresas que usam o STK Push mostram taxas de pagamento concluído 25% a 40% superiores às da cobrança passiva por Paybill. Combinado com lembretes por SMS, reduz de forma significativa o tempo médio de cobrança da renda todos os meses.

É possível usar o STK Push para cobrar rendas sem conhecimentos técnicos?

Sim, se usar um software de gestão de imóveis com o STK Push incorporado. Um software como o HomeManager trata de toda a integração por API, da infraestrutura de servidores e da associação dos pagamentos nos bastidores. Basta registar os inquilinos e os montantes das rendas, e o sistema trata do STK Push automaticamente. Sem programação, sem conhecimentos de APIs, sem gestão de servidores.

O que acontece se um inquilino recusar o pedido STK Push?

Se o inquilino recusar ou ignorar o pedido, nenhum pagamento é processado e nenhum dinheiro sai. O sistema de gestão de imóveis regista a tentativa recusada, o que lhe permite ver quem recebeu o pedido e não pagou. O sistema pode enviar automaticamente um lembrete por SMS, e o inquilino continua a poder pagar manualmente por Paybill a qualquer momento. O STK Push é um canal de cobrança adicional, não o único.

O STK Push é seguro para pagar rendas?

Totalmente seguro. O STK Push usa exatamente a mesma infraestrutura de segurança que todas as transações M-Pesa. Nenhum dinheiro sai sem o inquilino introduzir o seu PIN M-Pesa pessoal, o mesmo que usa em qualquer outro pagamento M-Pesa. A camada técnica passa pela API Daraja da Safaricom, através de ligações HTTPS encriptadas. Não há risco de segurança adicional em comparação com um inquilino que paga manualmente por Paybill.

Cobre a renda com um só toque

O HomeManager envia pedidos STK Push aos seus inquilinos no dia da renda. Eles introduzem o PIN e o senhorio vê o pagamento de imediato. Sem configurar APIs: já vem incorporado. O HomeManager funciona em toda a África; no Quénia, acrescenta o M-Pesa e o eTIMS.

Comece a cobrar com o STK Push

Pontos-chave

  • O STK Push envia um pedido de pagamento para o telemóvel do inquilino: basta introduzir o PIN para pagar
  • Elimina os erros (Paybill errado, conta errada, montante errado), porque todos os dados vêm preenchidos
  • Funciona em qualquer telemóvel com M-Pesa, seja smartphone ou telemóvel básico
  • Leva os senhorios de uma cobrança passiva (esperar) para uma cobrança ativa (enviar o pedido)
  • Exige integração por API, de que o software de gestão de imóveis trata por si
  • O HomeManager tem o STK Push incorporado, com envios automáticos, cálculo inteligente do montante e registo imediato
  • O STK Push não é uma solução milagrosa (os pedidos recusados continuam a precisar de acompanhamento), mas reduz muito os obstáculos para quem quer pagar
  • Fora do Quénia, o HomeManager cobra rendas por cartão e dinheiro móvel através da PesaPal nos países onde opera, e regista os pagamentos em todos os outros

Leituras relacionadas

Receba dicas de gestão de imóveis no seu e-mail:
Cobre a renda com o STK Push. O HomeManager envia os pedidos de pagamento automaticamente. Experimente grátis. Começar grátis