Migrate from Flutterwave
Replace Flutterwave Rave redirects and direct charge APIs with Watenga.js embedded checkout and platform webhooks.
Not legal advice
This documentation summarizes Watenga's integration and compliance posture for developers and merchants. It does not constitute legal, tax, or regulatory advice. Canonical policies live in our security documentation repository. Consult qualified counsel for jurisdiction-specific obligations.
Before you switch
- Inventory Flutterwave payment methods in use (cards, mobile money, bank transfer).
- Map Flutterwave
tx_refto Watenga checkout idempotency keys. - Remove client-side secret keys — Watenga secret keys stay server-side only.
Concept mapping
| Flutterwave | Watenga |
|---|---|
| Rave Standard / Inline | Watenga.js widget (embedded) |
| vbvsecurecode / 3DS | COPY&PAY 3DS inside iframe |
| Subaccounts | PayFac sub-merchant ledger |
| Transfers | Payouts in the Watenga dashboard (two-step verification); not in the API |
| Virtual accounts | Not applicable in v1 PayFac model |
API mapping
| Flutterwave | Watenga | Notes |
|---|---|---|
| POST /payments | POST /v1/checkout/create | — |
| GET /transactions/:id/verify | GET /v1/checkout/:id/status | — |
| POST /transactions/:id/refund | POST /v1/transactions/:id/refund | — |
| POST /transfers | Dashboard only | Payouts to your bank are made in the dashboard with two-step verification; not available through the API |
| GET /transfers | Dashboard only | Payout history is in the dashboard; payout webhooks report each result |
| POST /beneficiaries | POST /v1/merchant/bank-accounts | — |
| POST /virtual-account-numbers | Not applicable | PayFac aggregate settlement |
| POST /subscriptions | POST /v1/subscriptions | — |
| POST /payment-plans | POST /v1/subscriptions/subscription-plans | — |
| POST /mobile-money | Watenga.js wallet tab | USSD push in-widget |
| vbvsecurecode (3DS) | COPY&PAY 3DS | Handled inside EFT PAY iframe |
| Rave redirect | Watenga.js embedded | Customer stays on merchant site |
Webhooks
Flutterwave charge.completed maps to payment.capture.completed. See the webhook guide for signature verification and retries.
Embedded vs redirect
Watenga.js keeps customers on your site — no redirect to a hosted Rave page. See Watenga.js overview and integration paths.
Go live
- Complete KYC and per-market compliance: Markets & regulation.
- Issue live API keys from the Developer Dashboard.
- Enable mobile wallet methods per market via checkout branding settings.