API para programadores

Cobre e desembolse com poucas chamadas.

Uma API limpa, ao estilo Daraja: OAuth2 client-credentials, uma sandbox, pedidos de pagamento e webhooks assinados e reenviados — integre cobranças e pagamentos numa tarde.

Developers integrating the API

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
Fale connosco

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

4

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.

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