REST API v1

BongoPay Developer API

Integrate mobile money payments into any website or app. BongoPay handles all Selcom calls server-side — your customers never leave your platform.

USSD Push

Send a payment prompt directly to the customer's phone. No redirect needed.

Checkout Links

Generate a hosted checkout URL to share via WhatsApp or embed on your site.

Webhooks

Receive signed payment.paid / payment.failed events to your server instantly.

Base URL

https://bongopay.net/api/v1

Authentication

Every request needs your secret API key. Sign in to get yours.

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 customer phone
GET	`/payments/{reference}`	Get payment 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.

{
  "event": "payment.paid",
  "data": {
    "payment_reference": "BPY-20260518-AB12CD34",
    "status": "paid",
    "amount": 5000
  },
  "sent_at": "2026-05-20T04:24:51+00:00"
}

Ready to integrate?

Sign in to your merchant account to view your personalised API docs with your live key, response examples, and polling code.