Skip to content

Flutterwave SDKNode.js v4 API Integration

Type-safe, modern SDK for integrating Flutterwave payment services into your Node.js applications

Flutterwave SDK

Quick Start

Installation

bash
npm install flutterwave-node-v4
bash
yarn add flutterwave-node-v4
bash
pnpm add flutterwave-node-v4

Basic Usage

typescript
import { Flutterwave } from 'flutterwave-node-v4';

// Initialize the SDK
const flutterwave = new Flutterwave({
  clientId: 'your_client_id',
  clientSecret: 'your_client_secret',
  encryptionKey: 'your_encryption_key',
});

// Create a transfer
const transfer = await flutterwave.api.transfers.directTransfer({
  action: 'instant',
  reference: 'unique-ref-' + Date.now(),
  narration: 'Payment for services',
  type: 'bank',
  payment_instruction: {
    source_currency: 'NGN',
    destination_currency: 'NGN',
    amount: {
      value: 10000,
      applies_to: 'source_currency',
    },
    recipient: {
      bank: {
        account_number: '0690000031',
        code: '044',
      },
    },
    sender: {
      name: {
        first: 'John',
        last: 'Doe',
      },
    },
  },
});

console.log('Transfer ID:', transfer.id);

Why Choose This SDK?

This SDK is designed with developer experience in mind:

  • Type Safety: Full TypeScript support means fewer runtime errors
  • Modern: Uses latest JavaScript features and best practices
  • Tested: Comprehensive test coverage ensures reliability
  • Maintained: Regular updates to support new Flutterwave features
  • Open Source: Community-driven development with transparent roadmap

Community & Support

Released under the MIT License.