Choose your SDK
One matrix to answer every "which SDK should I use" question — language, product coverage, platform, status, and version, for all 14 official Wajub packages.
Three questions get you to the right package. If you already know your stack, skip to the full matrix below.
1. Where does your code run?
Pick one
Server (your backend calls the API with a private key) · Browser (you embed checkout in a web app) · Mobile app (native iOS/Android or cross-platform) · No code (you don't want to write integration code at all).
| Where it runs | Go to |
|---|---|
| Server (Node, PHP, Python, Go, Ruby, Java, .NET) | Server SDKs |
| Browser (checkout UI) | Web components |
| Mobile app (Flutter, React Native, Android, iOS) | Mobile |
| No code (WordPress, WooCommerce, hosted page) | No-code & plugins · Payment Links |
| None — raw HTTP | API Reference — every SDK is a thin wrapper over the same REST API |
2. What are you building?
Every server SDK exposes the same merchant API surface — Payments, Billing, Transfers, Sync, Shield, and Tax all go through the same client. The only real per-package variation is platform, not feature set: mobile SDKs only cover Payments (they render a payment sheet against a session your server creates), and web components only cover Payments and Payment Links (checkout UI, not merchant operations like refunds or payouts).
3. Which language or framework?
Jump straight to a page: Node.js · PHP · Python · Go · Ruby · Java · C# / .NET · JS · React · Vue · Svelte · Flutter · React Native · Android / Kotlin.
The full matrix
Server SDKs
Same client, same product coverage, across all 7 languages — pick by language, not by feature.
| Language | Package | Version | Status | Runtime | Payments | Billing | Transfers | Sync | Shield | Tax |
|---|---|---|---|---|---|---|---|---|---|---|
| Node.js | @wajub/node | 4.2.0 | Stable · GA | Node 18+ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| PHP | wajub/wajub-php | 3.2.1 | Stable · GA | PHP 8.2+ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Python | wajub (PyPI) | 2.8.0 | Stable · GA | Python 3.10+ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Go | github.com/wajub/wajub-go | v1.6.0 | Stable · GA | Go 1.22+ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Ruby | wajub (gem) | 2.4.0 | Stable · GA | Ruby 3.1+ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Java | com.wajub:wajub-java | 1.1.0 | Stable · GA | Java 17+ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| C# / .NET | Wajub (NuGet) | 2.0.0 | Stable · GA | .NET 8+ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
All 7 are pinned to API version 2026-08-01 by default and follow SDK naming
conventions for casing. Sync (private preview), Shield, and Tax
(beta) are reachable from every SDK — the client doesn't gate them — but the product itself
carries the preview/beta status, not the SDK. See each product's page for what's actually
production-ready today.
Web (browser)
Checkout UI only — not a general-purpose merchant client. Your backend creates the payment or session first with a server SDK; these packages render and confirm it in the browser.
| Package | Framework | Version | Status | Covers |
|---|---|---|---|---|
@wajub/js | Vanilla / CDN | 3.5.0 | Stable · GA | Payments, Payment Links |
@wajub/react | React 18+ / Next.js | 3.5.0 | Stable · GA | Payments, Payment Links |
@wajub/vue | Vue 3 | 3.1.0 | Stable · GA | Payments, Payment Links |
@wajub/svelte | Svelte 4+ | 2.0.0 | Stable · GA | Payments, Payment Links |
Mobile
Payment sheet only — not a merchant API client
Mobile SDKs render a native payment UI against a session your server creates with a server SDK. They do not expose refunds, payouts, Billing, Sync, Shield, or Tax — those stay server-side.
| Package | Platform | Version | Status | Requires |
|---|---|---|---|---|
wajub_mobile | Flutter | 1.4.0 | Stable · GA | Flutter 3.19+, Dart 3+ |
@wajub/react-native | React Native | 1.3.0 | Stable · GA | React Native 0.73+ |
co.wajub:wajub-mobile-core | Android (Kotlin) | 1.2.0 | Stable · GA | Android 8+ (API 26+) |
| — | iOS / Swift | — | ❌ Not available | — |
iOS / Swift — no dedicated package
There is currently no native Swift/iOS SDK. If you're building an iOS app, use one of these instead:
- React Native — full payment sheet, works on iOS today.
- Flutter — same, if you're open to a cross-platform rewrite.
- Hosted Checkout in a
WKWebView— no SDK dependency at all; open the Hosted Checkout URL your server generates in an in-app browser view.
A native Swift package is not on the public roadmap. If iOS is a hard requirement, contact support before you commit engineering time to an integration path.
No-code
| Tool | Covers | Version |
|---|---|---|
| WordPress plugin (incl. WooCommerce) | Payments, Payment Links | See plugin page |
| Payment Links | Payments, no code at all | Product, not a package |
| Invoice | Billing, no code at all | Product, not a package |
Still not sure?
Related pages
Was this page helpful?