Engineering · 11 min de lectura
API de desarrolladores
Cobra y desembolsa con unas pocas llamadas.
Una API limpia, estilo Daraja: OAuth2 client-credentials, un sandbox, solicitud de pago y webhooks firmados con reintentos — integra cobros y pagos en una tarde.
En detalle
La API de desarrolladores está hecha para el dinero, no solo para solicitudes. Intercambias credenciales de cliente por un token de corta duración, luego envías un cargo a un cliente; lo confirma en su monedero y recibes un webhook firmado en el momento en que se completa. Cada llamada es idempotente, así un reintento tras una conexión caída nunca cobra dos veces.
Un cargo avanza por un ciclo de vida claro — pendiente, autorizado, completado, rechazado o expirado — que puedes sondear o recibir por webhook. Los webhooks se firman con HMAC-SHA256 y se reintentan hasta su confirmación, para que tus sistemas confíen en cada callback, y las consultas de saldo y transacciones permiten conciliar. Un sandbox ejecuta el mismo contrato que producción, y los rieles se abstraen tras la API, así integras una vez y cambias de proveedor sin tocar tu código.
Por qué importa
Construida para ser de confianza.
- OAuth2 client-credentials con claves de sandbox y producción.
- Solicitud de pago (STK push) con sondeo de estado.
- Webhooks firmados con HMAC-SHA256 y reintentos en los que tus sistemas confían.
Resultados
- Integra en una tarde
- Concilia automáticamente
- Construye sobre un contrato estable
Qué incluye
API de desarrolladores — en detalle.
01
Tokens OAuth2
Intercambia credenciales de cliente por un token bearer.
02
Cargo y estado
Envía un cargo y sondea su ciclo de vida.
03
Webhooks
Callbacks firmados en el momento en que se completa un cargo.
04
Saldo e historial
Consulta saldos de cobro y transacciones.
Flujos reales
Cómo funciona en la práctica.
Cambia entre los recorridos que gestiona esta capacidad. Cada uno comprueba saldo y límites, y luego espera la autorización por PIN o biometría antes de asentar apuntes cuadrados en el libro mayor.
Envío del comercio (STK)
El comercio impulsa un cargo por su ciclo de vida; el cliente aprueba una solicitud.
Autorizado con PIN o biometría — nada se asienta en el libro mayor hasta que el cliente lo confirma.
- Se comprueban antes saldo y límites
- Control de validación / autorización
- Débitos y créditos cuadrados asentados
Cliente
Sistema
01
SistemaEl comercio envía un cargo
02
SistemaCrea cargo · estado = pendiente
ClienteLa solicitud aparece en el teléfono
03
04
Sistema · validaValida y comprueba saldo
Cliente · validaAutoriza — PIN o biometría
05
06
SistemaDebita al pagador, acredita al comercio
07
SistemaEstado = completado
08
SistemaWebhook firmado + reintento hasta confirmar
Sistema · listoPagado ✓ · recibo mostrado
Paso Validación / PIN Completado
190+
Países donde puedes lanzar
4
Apps nativas, una sola plataforma
4
Canales — App · USSD · Web · API
100%
Partida doble, siempre cuadrada
Más de la plataforma
Un núcleo, cada capacidad.
Lecturas recomendadas
Guías del equipo de PesaBridge
Artículos en inglés.
Sigue explorando
Adónde ir ahora
¿Listo para lanzar tu monedero?
Solicita una demo y montaremos tu marca, país y rieles — y te guiaremos por las apps, el panel y la API.
¿Prefieres hablar? Llama al +254 746 883809