Programadores

Feito para os programadores de cada empresa que assinar.

Uma API REST com chaves publicáveis e secretas, webhooks assinados, idempotência e uma sandbox. As empresas integram numa tarde; nunca escreve o código delas.

# Create a checkout with the business's publishable key
curl -s https://pesa-bridge.com/api/bridgepay/v1/checkout/create \
  -H "Content-Type: application/json" \
  -d '{"key":"pk_test_...","amount":4800,"currency":"KES",
       "reference":"ORDER-1042",
       "success_url":"https://shop.example/thanks",
       "cancel_url":"https://shop.example/cart"}'
<- 200 {"checkout_id":"chk_8Q2T","url":".../pay/chk_8Q2T","status":"open"}
-> send the shopper to url

Início rápido

Das chaves à produção em cinco passos.

  1. 1

    Obter chaves

    Chaves de teste e de produção no portal do programador em minutos.

  2. 2

    Criar um pagamento

    Uma chamada com a chave publicável devolve o endereço da página.

  3. 3

    Ouvir os eventos

    Adicione um endpoint de webhook e verifique a assinatura.

  4. 4

    Testar cada resultado

    Use os números da sandbox para aprovar, recusar ou deixar expirar.

  5. 5

    Entrar em produção

    Passe a lista de verificação e mude para as chaves de produção.

Sandbox

Teste cada resultado antes de mover dinheiro real.

Com chaves de teste, cada chamada corre na sandbox. Os últimos dígitos do telefone de quem paga escolhem o resultado:

…0002Recusado por quem paga
…0003Saldo insuficiente
…0004Expira sem resposta
qualquer outroAprovado

Ferramentas

Tudo o que os programadores esperam.

Especificação OpenAPI

Gere um cliente em qualquer linguagem a partir da especificação publicada.

Consola e registos

Experimente chamadas, veja cada pedido, evento e entrega.

Ferramentas de webhooks

Endpoints com segredos próprios, eventos de teste, um recetor de eco alojado e reenvios.

Idempotência e limites

Chaves de idempotência nas escritas, erros claros, e 429 com indicação de quando repetir.

Eventos

Eventos de pagamento, reembolso, disputa, liquidação e subscrição, tipados e com versão.

Verificações para produção

Uma lista de verificação que bloqueia as chaves de produção até o essencial estar certo.

Portal do programador

A sua marca também no portal do programador.

As empresas obtêm chaves, documentação, registos e webhooks num portal do programador com as suas cores e o seu domínio.

Saber mais

Perguntas

Perguntas que os operadores fazem

Há bibliotecas cliente?

Exemplos de código em cURL, Node.js, Python e PHP, e a especificação OpenAPI para gerar um cliente tipado em qualquer linguagem.

O modo de teste toca em dinheiro real?

Não. As chaves de teste só correm na sandbox; as chaves de produção recusam dados da sandbox.

Como são tratadas as alterações da API?

Os campos novos são acrescentados sem quebrar as chamadas existentes, e cada alteração fica no registo de alterações.

Lance o seu próprio gateway de pagamentos.

Diga-nos os seus mercados e as empresas que serve. Enviamos uma proposta com planos, redes de pagamento e um plano de lançamento, e uma demonstração com a sua marca que pode abrir no mesmo dia.