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 PushLimitaçõ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 PushPontos-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
