Construa com a API da PesaBridge.
Guias de cobranças, pagamentos, checkout alojado e webhooks, com exemplos para colar diretamente no seu terminal. Tudo é testado primeiro no sandbox.
https://pesa-bridge.com/api/bridgepay/v1
53 endpoints · OpenAPI 3 · JSON sobre HTTPS
Ferramentas
Tudo o que precisa ao lado dos guias
Referência da API
Uma superfície pequena e previsível.
/oauth/tokenTroque credenciais de cliente por um token bearer./partner/stkEnvie uma cobrança (pedido de pagamento) a um cliente./partner/statusConsulte o estado de uma cobrança./partner/balanceConsulte o saldo de uma conta de cobrança./biz/requestPedido de pagamento do comerciante./ussdCallback do gateway de menus USSD.Canais e integrações
Ligue apenas o que o seu mercado precisa.
Os canais são adaptadores plugáveis com uma só interface — cobrar, pagar, saldo e callbacks — para que um novo conector nunca toque no núcleo.
Bancos
Liquidação RTGS / ACH / SWIFT / SEPA e gestão de nostro.
Mobile money
As operadoras de mobile money de cada mercado, via adaptadores de canais.
Cartões e PSPs
Aquisição nas principais redes de cartões e integrações com processadores.
Faturadores e operadoras
Serviços públicos, TV, governo, propinas e carregamento de saldo.
Concebida para dinheiro
Uma API que se comporta como um sistema de pagamentos.
A maioria das APIs move dados. Esta move dinheiro — por isso é idempotente, assinada e construída em torno de um ciclo de vida de cobrança em que pode confiar.
A autenticação é OAuth2 client-credentials: troca uma chave e um segredo por um token bearer de curta duração. Cada chamada que altera estado transporta uma chave de idempotência, para que uma repetição por falha de rede liquide exatamente uma vez — a propriedade mais importante quando há dinheiro real envolvido.
Uma cobrança é uma cobrança. Envia-a para o número de um cliente; um pedido de pagamento surge no telemóvel; ele confirma com um PIN. A cobrança percorre os estados pendente → autorizada → concluída (ou recusada / expirada / falhada), e o resultado chega-lhe de duas formas: consultando o endpoint de estado ou — melhor — recebendo um webhook no momento em que muda.
Os webhooks são assinados com HMAC-SHA256 usando um segredo que só você e o PesaBridge partilham, e reenviados com recuo progressivo até o seu endpoint confirmar — para que possa construir sobre eles sem receio de um evento perdido ou forjado. Os endpoints de saldo e transações fecham o ciclo da reconciliação, e uma sandbox executa o mesmo contrato, para que lance com confiança.
Ciclo de vida da cobrança
{
"event": "charge.completed",
"charge_ref": "STK9F2A",
"amount": 250.00,
"currency": "KES",
"state": "completed",
"signature": "hmac-sha256…"
}Segurança e conformidade
A confiança é o produto.
Os serviços financeiros vivem ou morrem pela exatidão e pelo controlo. O PesaBridge incorpora ambos no núcleo.
Partidas dobradas por construção
Cada movimento regista débitos e créditos equilibrados — os livros reconciliam a zero, sempre.
PIN, KYC e limites
Níveis de KYC configuráveis, limites por transação e diários, tentativas de PIN e bloqueio de carteira.
Idempotente e reversível
As chaves de idempotência impedem cobranças em duplicado; um motor de reversão unificado desfaz qualquer departamento.
Webhooks assinados
Assinaturas HMAC-SHA256 e reenvios para que os sistemas parceiros confiem em cada callback.
Trilho de auditoria completo
Lançamentos de razão imutáveis e histórico de transações para reguladores e disputas.
Conformidade por país
Tipos de documento, regras de KYC e tarifas mudam com o mercado, a partir da configuração.
Ficou bloqueado?
Os nossos engenheiros respondem a dúvidas de integração. Envie-nos a referência do pedido e encontramos a chamada exata.