Flutterwave Payment Setup

Overview

This guide explains how to configure Flutterwave as a payment provider in your AppTree project. Flutterwave enables you to accept payments from customers in multiple African countries and beyond, supporting various payment methods including cards, bank transfers, and mobile money.

Prerequisites

• An active Flutterwave account
• Access to your AppTree project settings
• Basic understanding of Webhook configurations

Step 1: Get Flutterwave API Keys

1.1 Access Flutterwave Dashboard

1. Log in to your Flutterwave Dashboard
2. Navigate to Settings → API Keys

1.2 Get API Keys from Flutterwave

1. Public Key: Copy your public key (starts with FLWPUBK_)
2. Secret Key: Copy your secret key (starts with FLWSECK_)
3. Encryption Key: Copy your encryption key (used for data encryption)

Step 2: Configure AppTree Project Settings

2.1 Access E-commerce Settings

1. In your AppTree project, go to Sales → Settings
2. Scroll down to Payment Provider Configuration
3. Select Flutterwave from the dropdown

2.2 Enter Flutterwave Credentials

Fill in the following fields:

• Flutterwave Public Key: Your public key from Step 1.2
• Flutterwave Secret Key: Your secret key from Step 1.2
• Flutterwave Encryption Key: Your encryption key from Step 1.2
• Flutterwave Webhook Secret: Your webhook secret from Step 1.3

2.3 Save Configuration

1. Click Save Settings
2. Wait for the configuration to be processed
3. Verify that the status shows as "Configured"

Step 3: Configure Flutterwave Webhook

3.1 Get Your Webhook URL

After saving the configuration, AppTree will generate a webhook URL in this format:

<https://api.apptree.so/flutterwave/{PROJECT_ID}/webhook>

1. Copy this URL from your project settings.
2. Fill in the webhook Secret field and note it down (you'll need it later)

3.2 Set Up Webhook in Flutterwave Dashboard

1. Go back to Flutterwave Dashboard → Settings → Webhooks
2. Click Add Webhook
3. Enter the webhook URL from Step 3.1
4. Set the webhook secret (use the same one from Step 3.1)
5. Click Save

( Note: The Webhook Secret entered in the Flutterwave dashboard and your project settings must be same )

Step 4: Test the Integration

4.1 Create a Test Order

1. Go to your project's store
2. Add items to cart
3. Proceed to checkout

4.2 Complete Test Payment

1. Use Flutterwave's test card numbers:
• Visa: 4000 0000 0000 0002
• Mastercard: 5200 8300 0000 0001
2. Enter any future expiry date
3. Use any 3-digit CVV
4. Complete the payment
5. Enter any 4 digit otp

Step 5: Go Live

5.1 Switch to Production Mode

1. In Flutterwave Dashboard, Activate your account by adding necessary details and documents (Activate Account now button)
2. Your account is automatically switched to live mode once your verification is completed and approved.