Official SDKs
Server SDKs call the API with your secret key; browser and app SDKs show the checkout with a publishable key and a checkout session your server created. They all speak API version 2026-10-29.
One API, one host
Every SDK talks to
https://api.watenga.africa. Test or live is decided by the key (sk_test_… / sk_live_…): a test key never moves money.Server SDKs
The same resources and method names in every language, generated types from the OpenAPI document, one error type with code, request_id, param and doc_url, retries with an Idempotency-Key on every write, auto-pagination, and webhook verification that accepts two secrets while you rotate.
| Language | Package | Install |
|---|---|---|
| Node.js | @watenga/node | npm install @watenga/node |
| Python | watenga | pip install watenga |
| PHP | watenga/watenga-php | composer require watenga/watenga-php |
| Go | github.com/watenga-africa/watenga-go | go get github.com/watenga-africa/watenga-go |
| Dart (server) | watenga_flutter | dart pub add watenga_flutter |
Browsers and apps
| Platform | Package | What it is |
|---|---|---|
| Web | Watenga.js | Embedded checkout in one script tag (card entry in the gateway frame, PCI SAQ A); events onReady, onPending, onSuccess, onCancel, onError |
| iOS | Watenga | SwiftUI payment sheet (Swift Package Manager, CocoaPods) |
| Android | africa.watenga:watenga-android | Jetpack Compose payment sheet (Maven Central) |
| React Native | @watenga/react-native | Payment sheet for React Native and Expo |
| Flutter | watenga_flutter_ui | Flutter payment sheet |
The app sheets offer the methods, wallets, currencies and phone formats of your market (from the server) and draw your Checkout Studio design.
Tools
| Tool | Package | What it does |
|---|---|---|
| CLI | @watenga/cli | watenga listen, trigger and logs tail; API calls from a terminal |
| MCP server | @watenga/mcp | Your AI assistant works with your account through the API, with your key and its scopes |
Release status
The packages are release-ready and published by Watenga's release workflow. Until a package is on its registry, its page shows how to install it from a checkout of the Watenga repository. Watenga.js is always on
https://js.watenga.africa/v1/watenga.js.Refunds through the API; payouts in the dashboard
A secret key refunds when its app's Refunds switch is on and an Admin has set the app's refund limits; a restricted key needs the
refunds scope (Refunds). Payouts to your bank are dashboard-only, with two-step verification: they are not in the API, the SDKs or the CLI.