Construye con la API de PesaBridge.
Guías de cobros, pagos, checkout alojado y webhooks, con ejemplos que puedes pegar directamente en tu terminal. Todo se prueba primero en el sandbox.
https://pesa-bridge.com/api/bridgepay/v1
53 endpoints · OpenAPI 3 · JSON sobre HTTPS
Herramientas
Todo lo que necesitas junto a las guías
Referencia de la API
Una superficie pequeña y predecible.
/oauth/tokenIntercambia credenciales de cliente por un token bearer./partner/stkEnvía un cargo (solicitud de pago) a un cliente./partner/statusSondea el estado de un cargo./partner/balanceConsulta el saldo de una cuenta de cobro./biz/requestSolicitud de pago del comercio./ussdCallback de la pasarela de menú USSD.Redes e integraciones
Conecta solo lo que tu mercado necesita.
Los redes son adaptadores conectables con una sola interfaz — cobrar, pagar, saldo y callbacks — para que un nuevo conector nunca toque el núcleo.
Bancos
Liquidación RTGS / ACH / SWIFT / SEPA y gestión de nostro.
Dinero móvil
Los operadores de dinero móvil de cada mercado, mediante adaptadores de riel.
Tarjetas y PSP
Adquirencia en las principales redes de tarjetas e integraciones con procesadores.
Facturadores y telco
Servicios básicos, TV, gobierno, matrículas y recarga de saldo.
Diseñada para el dinero
Una API que se comporta como un sistema de pagos.
La mayoría de las API mueven datos. Esta mueve dinero — por eso es idempotente, firmada y construida en torno a un ciclo de vida de cargo en el que puedes confiar.
La autenticación es OAuth2 client-credentials: intercambias una clave y un secreto por un token bearer de corta duración. Cada llamada que cambia el estado lleva una clave de idempotencia, así un reintento de red se liquida exactamente una vez — la propiedad más importante cuando hay dinero real de por medio.
Un cobro es un cargo. Lo envías al número de un cliente; le llega una solicitud de pago al teléfono; lo confirma con un PIN. El cargo avanza por pendiente → autorizado → completado (o rechazado / expirado / fallido), y conoces el resultado de dos maneras: sondeas el endpoint de estado o — mejor — recibes un webhook en el momento en que cambia.
Los webhooks se firman con HMAC-SHA256 contra un secreto que solo tú y PesaBridge comparten, y se reintentan con backoff hasta que tu endpoint los confirma — así puedes apoyarte en ellos sin temer un evento perdido o falsificado. Los endpoints de saldo y transacciones cierran el círculo de la conciliación, y un sandbox ejecuta el contrato idéntico, para que despliegues con confianza.
Ciclo de vida del cargo
{
"event": "charge.completed",
"charge_ref": "STK9F2A",
"amount": 250.00,
"currency": "KES",
"state": "completed",
"signature": "hmac-sha256…"
}Seguridad y cumplimiento
La confianza es el producto.
Los servicios financieros viven o mueren por la exactitud y el control. PesaBridge integra ambos en el núcleo.
Partida doble por construcción
Cada movimiento asienta débitos y créditos cuadrados — los libros cuadran a cero, siempre.
PIN, KYC y límites
Niveles de KYC configurables, límites por transacción y diarios, intentos de PIN y bloqueo de monedero.
Idempotente y reversible
Las claves de idempotencia frenan los cobros dobles; un motor de reversos unificado deshace cualquier departamento.
Webhooks firmados
Firmas HMAC-SHA256 y reintentos para que los sistemas socios confíen en cada callback.
Pista de auditoría completa
Asientos de libro mayor inmutables e historial de transacciones para reguladores y disputas.
Cumplimiento por país
Tipos de documento, reglas de KYC y tarifas cambian con el mercado, desde la configuración.
¿Te has atascado?
Nuestros ingenieros responden dudas de integración. Envíanos la referencia de la solicitud y encontraremos la llamada exacta.