Dashboard
DocsTelegram & Discord Subscription Bot — Flutterwave Setup

Flutterwave for Your Telegram & Discord Subscription Bot

Connect Flutterwave to accept hosted card payments for your Telegram subscription bot or Discord subscription bot. Members complete payment on Flutterwave's checkout page, and BotSubscription manages their membership access.

This integration supports individual payments. When a member chooses a recurring plan, each renewal requires another payment; Flutterwave does not automatically charge a saved card through this integration.

Prepare Flutterwave for subscription payments

Use a Flutterwave merchant account with card payments enabled. In its dashboard, open Settings → API Keys and copy the Secret Key for the environment you want to connect.

Create your own random Webhook Secret Hash of at least 16 characters. You will enter the same value in Flutterwave and BotSubscription. Keep both credentials private.

BotSubscription supports these Flutterwave card-checkout currencies: NGN, USD, EUR, GBP, GHS, ZAR, KES, UGX, TZS, EGP, XAF, XOF, RWF, and MWK. Availability also depends on your Flutterwave account.

Connect Flutterwave to your subscription bot

  1. Open Settings → Merchant Accounts → Install Merchant Account in your project's bot.
  2. Select Flutterwave and choose Sandbox for testing or Production for real payments.
  3. Enter the matching Secret Key and your Webhook Secret Hash, then submit the form.
  4. Copy the webhook URL supplied by BotSubscription. Keep the account's setup instructions available for the next step.

Use Test credentials with Sandbox and Live credentials with Production. The subscription bot environment guide explains how to keep test and real payments separate.

Configure Flutterwave payment notifications

Review the Flutterwave webhook requirements for the provider's current dashboard instructions.

In the matching Flutterwave dashboard environment, open Settings → Webhooks. Enter the URL from BotSubscription and the same Secret Hash, then enable webhook retries.

Ask Flutterwave support to enable chargeback webhooks for your account. For refund notifications, open V3 Webhooks → Webhook preferences with custom url, enable webhooks for refunds, and use the same URL.

These notifications tell BotSubscription about payment changes; they are separate from outbound integration webhooks sent to your own application.

Verify checkout and subscription access

Complete a test payment in Sandbox and check that membership access is granted. The first verified payment notification verifies the account's webhook. If setup remains pending, check the URL, Secret Hash, and selected environment before accepting real payments.

For currency comparisons, see supported subscription payment currencies.

Last updated: