Ingeniería · 11 min de lectura
API de desarrolladores
Cobra y desembolsa con unas pocas llamadas.
Una API limpia, pensada para el móvil: 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 redes 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
6
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.
Preguntas
API de desarrolladores: lo que preguntan los equipos antes del lanzamiento
¿Cómo nos autenticamos?
Con credenciales de cliente OAuth2: cambie su ID de cliente y su secreto por un token bearer. El entorno de pruebas y producción usan claves distintas.
¿Hay un entorno de pruebas?
Sí. Regístrese para obtener claves de prueba y pruebe cobros, estados y webhooks antes de salir en vivo, con la misma API que en producción.
¿Cómo sabemos que un pago se completó?
Consulte el estado del cobro o reciba un webhook en cuanto se complete. Los webhooks se firman con HMAC-SHA256, y un envío sin respuesta 2xx se reintenta hasta 10 veces durante unos dos días.
¿Podemos cobrar y pagar a través de la API?
Sí. Envíe solicitudes de pago para cobrar, y consulte los saldos de cobro y el historial de transacciones para la conciliación.
¿Dónde está la referencia?
La documentación para desarrolladores cubre cada endpoint, solicitud y respuesta, con guías de checkout, webhooks y salida en vivo.
Lecturas recomendadas
Guías del equipo de PesaBridge
Sigue explorando
Adónde ir ahora
¿Listo para lanzar tu monedero?
Solicita una demo y montaremos tu marca, país y redes — y te guiaremos por las apps, el panel y la API.
¿Prefieres hablar? Llama al +254 746 883809