PesaBridge
Docs/Receber/Hosted checkout and payment links

Receber

Hosted checkout and payment links

A ready-made payment page: create a session, redirect the customer, get the result.

3 min de leitura

Os guias para programadores estão em inglês para que o código, os nomes dos campos e as mensagens de erro correspondam exatamente à API.

Nesta página
  1. Create a session
  2. Send the customer there
  3. Check the result

Create a session

Hosted checkout needs no token: it uses your publishable key, so you can call it from a simple back end or a no-code tool. Send a fixed amount, or a catalogue product SKU so the price can't be tampered with.

Request
curl -s https://pesa-bridge.com/api/bridgepay/v1/checkout/create \
  -H "Content-Type: application/json" \
  -d '{"key":"pk_test_…","amount":100,"reference":"ORDER-9",
       "success_url":"https://your-app.com/thanks","cancel_url":"https://your-app.com/cart"}'
Response
{ "checkout_id": "chk_123", "url": "https://pesa-bridge.com/api/bridgepay/v1/pay/chk_123", "status": "open" }

Send the customer there

Redirect to url, or share it as a payment link by SMS, email or chat. The customer pays on a PesaBridge page and returns to your success_url.

Don't treat the return to success_url as proof of payment. Confirm with the checkout.completed event or by polling the status.

Check the result

Shell
curl -s https://pesa-bridge.com/api/bridgepay/v1/pay/chk_123/status
AnteriorAccept paymentsSeguinte Send money (payouts)

Os nossos engenheiros respondem a dúvidas de integração. Envie-nos a referência do pedido e encontramos a chamada exata.

Contactar o suporte