Guides & tutorials
Step-by-step paths for the most common integrations — collecting payments, refunding, integrating with React, going live, and migrating.
6 min read
These guides combine the API building blocks into complete walkthroughs. Each one starts from a concrete goal and takes you all the way to a working integration.
Which guide should I pick?
Choose the guide that matches your current goal — you don't need to read them in order.
- Accept a payment — Start here if you're brand new. Covers the fundamental flow every integration depends on.
- Handle refunds — Pick this once you've successfully processed a payment and need to add refund logic.
- Integrate with React / Next.js — Use this if you're building a frontend in React and need the client + server architecture right.
- Go-live checklist — Follow this before switching from test mode to production.
- Migrate from another provider — Read this when you're moving an existing integration to Wajub without downtime.
Learning path
If you're building from scratch, follow this sequence for the smoothest experience:
| Order | Guide | Level | Why |
|---|---|---|---|
| 1 | Accept a payment | Beginner | Learn the core API flow; everything else builds on this |
| 2 | Integrate with React / Next.js | Intermediate | Connect your frontend securely to the payment flow |
| 3 | Handle refunds | Intermediate | Add the second most common operation after accepting payments |
| 4 | Go-live checklist | Advanced | Validate error handling, webhooks, and monitoring before production |
| 5 | Migrate from another provider | Advanced | Move existing volume without double-billing or downtime |
Available paths
Accept a paymentguideoptionalThe complete flow, from click to webhook. → /getting-started/guides/accept-a-payment
Handle refundsguideoptionalFull, partial, and reconciliation. → /getting-started/guides/handle-refunds
Integrate with React / Next.jsguideoptionalSecure client + server architecture. → /getting-started/guides/integrate-react
Go-live checklistguideoptionalValidate everything before production. → /getting-started/guides/go-live-checklist
Migrate from another providerguideoptionalZero-downtime strategy. → /getting-started/guides/migrate-provider
Keep Konsole open
As you follow a guide, keep Konsole open in a tab: you see every request going out and every webhook coming in, which greatly speeds up debugging.