BongoPay Developer API

Integrate mobile money into any website or app. BongoPay makes every Selcom call server‑side — your customers never leave your platform, and your keys never touch the browser.

Base URL

https://bongopay.net/api/v1

Authentication

Every request needs your secret API key. Generate one from your dashboard.

Authorization: Bearer sk_live_xxxxxxxxx
Content-Type: application/json

Never expose your secret key in frontend JavaScript or mobile apps — use it only from your server.

Endpoints

Method	Endpoint	Description
POST	`/payments/create`	Create a hosted checkout link
POST	`/pay-via-mobile`	USSD push to the customer's phone
GET	`/payments/{reference}`	Get a payment's status
GET	`/transactions`	List recent transactions
GET	`/balance`	Account balance
POST	`/webhooks/test`	Trigger a test webhook event

Quick example — USSD push

curl -X POST https://bongopay.net/api/v1/pay-via-mobile \
  -H "Authorization: Bearer sk_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "phone": "255744000000",
    "amount": 5000,
    "transaction_id": "ORDER-1001"
  }'

Webhook events

BongoPay sends signed POST requests to your callback_url on every status change.