Engenharia · 11 min de leitura
API para programadores
Cobre e desembolse com poucas chamadas.
Uma API limpa, pensada para o telemóvel: OAuth2 client-credentials, uma sandbox, pedidos de pagamento e webhooks assinados e reenviados — integre cobranças e pagamentos numa tarde.
Em detalhe
A API para programadores foi feita para dinheiro, não apenas para pedidos. Troca credenciais de cliente por um token de curta duração, depois envia uma cobrança a um cliente; ele confirma na carteira, e recebe um webhook assinado no momento em que compensa. Cada chamada é idempotente, por isso uma repetição após uma ligação interrompida nunca cobra em duplicado.
Uma cobrança percorre um ciclo de vida claro — pendente, autorizada, concluída, recusada ou expirada — que pode consultar ou receber por webhook. Os webhooks são assinados com HMAC-SHA256 e reenviados até serem confirmados, para que os seus sistemas confiem em cada callback, e as consultas de saldo e transações permitem-lhe reconciliar. Uma sandbox executa o mesmo contrato que a produção, e os canais são abstraídos por trás da API, por isso integra uma vez e troca de fornecedor sem alterar o seu código.
Porque importa
Feito para ser de confiança.
- OAuth2 client-credentials com chaves de sandbox e de produção.
- Pedido de pagamento (STK push) com consulta de estado.
- Webhooks assinados com HMAC-SHA256 e reenviados em que os seus sistemas confiam.
Resultados
- Integre numa tarde
- Reconcilie automaticamente
- Construa sobre um contrato estável
O que inclui
API para programadores — em detalhe.
01
Tokens OAuth2
Troque credenciais de cliente por um token bearer.
02
Cobrança e estado
Envie uma cobrança e consulte o seu ciclo de vida.
03
Webhooks
Callbacks assinados no momento em que uma cobrança compensa.
04
Saldo e histórico
Consulte saldos de cobrança e transações.
Fluxos reais
Como funciona na prática.
Alterne entre os percursos que esta capacidade trata. Cada um verifica saldo e limites, depois aguarda autorização por PIN ou biometria antes de registar lançamentos equilibrados na razão.
Envio do comerciante (STK)
O comerciante envia uma cobrança pelo seu ciclo de vida; o cliente aprova um pedido.
Autorizado com PIN ou biometria — nada é registado na razão até o cliente confirmar.
- Saldo e limite verificados primeiro
- Barreira de validação / autorização
- Débitos e créditos equilibrados registados
Cliente
Sistema
01
SistemaComerciante envia uma cobrança
02
SistemaCriar cobrança · estado = pendente
ClientePedido surge no telemóvel
03
04
Sistema · validaValidar e verificar saldo
Cliente · validaAutorizar — PIN ou biometria
05
06
SistemaDebitar pagador, creditar comerciante
07
SistemaEstado = concluída
08
SistemaWebhook assinado + reenvio até confirmar
Sistema · concluídoPago · recibo mostrado
Passo Validação / PIN Concluído
190+
Países onde pode lançar
6
Aplicações nativas, uma plataforma
4
Canais — App · USSD · Web · API
100%
Partidas dobradas, sempre equilibrado
Mais da plataforma
Um núcleo, todas as capacidades.
Perguntas
API para programadores: o que as equipas perguntam antes do lançamento
Como nos autenticamos?
Com credenciais de cliente OAuth2: troque o seu ID de cliente e o segredo por um token bearer. A sandbox e a produção usam chaves separadas.
Existe uma sandbox?
Sim. Registe-se para obter chaves de sandbox e teste cobranças, estados e webhooks antes de entrar em produção, com a mesma API da produção.
Como sabemos que um pagamento foi concluído?
Consulte o estado da cobrança ou receba um webhook no momento em que é concluída. Os webhooks são assinados com HMAC-SHA256, e um envio sem resposta 2xx é repetido até 10 vezes ao longo de cerca de dois dias.
Podemos receber e pagar através da API?
Sim. Envie pedidos de pagamento para receber, e consulte saldos de cobrança e o histórico de transações para a reconciliação.
Onde está a referência?
A documentação para programadores cobre cada endpoint, pedido e resposta, com guias de checkout, webhooks e entrada em produção.
Continue a explorar
Para onde ir a seguir
Pronto para lançar a sua carteira?
Agende uma demonstração e criamos a sua marca, país e canais — e mostramos-lhe as apps, o painel e a API.
Prefere falar? Ligue para +254 746 883809