Guides & tutorials
Step-by-step paths for the most common integrations — collecting payments, refunding, integrating with React, going live, and migrating.
4 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.
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 | Advanced | Validate error handling, webhooks, and monitoring before production |
| 5 | Migrate from another provider | Advanced | Move existing volume without double-billing or downtime |
All guides
Related pages
Accept a paymentThe complete flow, from click to webhook confirmation.Handle refundsFull, partial, and reconciliation.Integrate with React / Next.jsSecure client + server architecture.Mobile Money checkoutEnd-to-end Mobile Money flow with USSD and push payment handling.Subscription billingBuild recurring billing on top of the Payments API.Migrate from another providerZero-downtime migration strategy.
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.
Was this page helpful?