Flutterwave

This guide will walk through setting up your Flutterwave account in CheckoutJoy

Supported Payment Options

  • One-time payments
  • Multiple payments
  • Subscriptions

Adding your account details

In the CheckoutJoy dashboard

  1. Navigate to Settings > Payment Methods
  2. Select your payment processor and click on Add

Finding your API Key ID and Secret

  1. Log into your Flutterwave account
  2. Navigate to **Settings > API keys **

Setting up webhook notifications

CheckoutJoy needs to be notified of any payment events such as successful payment authorizations or refunds in order to manage your customer's access to your Kajabi offers.

To do this you need to add the CheckoutJoy webhook API address to your Flutterwave Webhook configuration.

In your Flutterwave dashboard,

  • Navigate to Settings > Webhooks
  • Select the Add New Webhook button top right
  • Check all the boxes and save your settings
SettingValue
Webhook URLhttps://api.checkoutjoy.com/v1/notify?p=Flutterwave
PreferencesSelect all events

Merchant eligibility

Flutterwave's merchant onboarding is country- and entity-restricted. Most onboarding paths require:

  • A business registered in one of Flutterwave's supported African markets (Nigeria, Kenya, Ghana, Uganda, South Africa, Tanzania, Rwanda, Zambia and similar).
  • A local bank account in that market for settlements.
  • Local KYC documentation for the registered entity.

Common rejections:

  • US-based merchants (including registered non-profits) typically cannot onboard with Flutterwave — there's no path to settle to a US bank account.
  • EU/UK-based merchants generally aren't eligible either.

If Flutterwave isn't a fit for your jurisdiction, the next-best options for African-currency settlement are Paystack (South Africa, Nigeria, Ghana, Ivory Coast) or PayFast (South Africa). For non-African merchants selling into Africa, Stripe and PayPal are the realistic alternatives — they won't give buyers local rails like mobile money, but they will clear cards from those markets.

CheckoutJoy will connect any active Flutterwave account — the limitation is on Flutterwave's onboarding, not the integration.

Flutterwave