Flutterwave Angular Library

Introduction

The Angular SDK helps you create seamless payment experiences in your Angular mobile or web app. By connecting to our modal, you can start collecting payment in no time.

Available features include:

• Collections: Card, Account, Mobile Money, Bank Transfers, USSD, Barter, NQR.
• Recurring payments: Tokenization and Subscriptions.
• Split payments

Table of Contents

1. Requirements
2. Installation
3. Initialization
4. Usage
5. Support
6. Contribution Guidelines
7. License
8. Changelog

Requirements

1. Flutterwave version 3 API keys
2. Node version >= 14.15.0 and npm >= 6.14.8
3. Angular version >= 18.

Installation

Install the SDK

$ npm install flutterwave-angular-v3
# or
$ yarn  add  flutterwave-angular-v3

Initialization

Import FlutterwaveModule to the app root module

import { FlutterwaveModule } from "flutterwave-angular-v3"

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,
    FlutterwaveModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})

NB: If you experience compilation errors in your app after importing the Flutterwave module, component or service. Kindly include the following line in tsconfig.app.json under compilerOptions :

paths": { "@angular/*": [ "node_modules/@angular/*" ] }

Then restart server and try again

Usage

Add Flutterwave to your project as a component or directly in your code:

1. As a Component
2. Directly in your code
3. Recurring Payments

Using Flutterwave as a Component

Method 1

Pass in payment parameters individually as component attributes.

import { Component, OnInit } from "@angular/core";
import {
  FlutterwaveService,
  InlinePaymentOptions,
  PaymentSuccessResponse,
} from "flutterwave-angular-v3";
@Component({
  selector: "app-root",
  template: ` <flutterwave-make-payment
    [public_key]="publicKey"
    amount="10"
    currency="NGN"
    payment_options="card"
    redirect_url=""
    text="Pay Now"
    [customer]="customerDetails"
    [customizations]="customizations"
    [meta]="meta"
    [tx_ref]="generateReference()"
    (callback)="makePaymentCallback($event)"
    (close)="closedPaymentModal()"
  >
  </flutterwave-make-payment>`,
})
export class AppComponent {
  //use your PUBLIC_KEY here
  publicKey = "FLWPUBK_TEST-XXXXX-X";

  customerDetails = {
    name: "Demo Customer  Name",
    email: "customer@mail.com",
    phone_number: "08100000000",
  };

  customizations = {
    title: "Customization Title",
    description: "Customization Description",
    logo: "https://flutterwave.com/images/logo-colored.svg",
  };

  meta = { counsumer_id: "7898", consumer_mac: "kjs9s8ss7dd" };

  constructor(private flutterwaveService: FlutterwaveService) {}

  makePaymentCallback(response: PaymentSuccessResponse): void {
    console.log("Pay", response);
    this.flutterwaveService.closePaymentModal(5);
  }
  closedPaymentModal(): void {
    console.log("payment is closed");
  }
  generateReference(): string {
    let date = new Date();
    return date.getTime().toString();
  }
}

Method 2

Pass in the payment parameters as an object to the component data attribute.

import { Component, OnInit } from "@angular/core";
import {
  FlutterwaveService,
  InlinePaymentOptions,
  PaymentSuccessResponse,
} from "flutterwave-angular-v3";

@Component({
  selector: "app-root",
  template: ` <flutterwave-make-payment
    [data]="paymentData"
  ></flutterwave-make-payment>`,
})
export class AppComponent {
  publicKey = "FLWPUBK_TEST-0b0-XXXXXXXXXXX";

  customerDetails = {
    name: "Demo Customer  Name",
    email: "customer@mail.com",
    phone_number: "08100000000",
  };

  customizations = {
    title: "Customization Title",
    description: "Customization Description",
    logo: "https://flutterwave.com/images/logo-colored.svg",
  };

  meta = { counsumer_id: "7898", consumer_mac: "kjs9s8ss7dd" };

  paymentData: InlinePaymentOptions = {
    public_key: this.publicKey,
    tx_ref: this.generateReference(),
    amount: 10,
    currency: "NGN",
    payment_options: "card,ussd",
    redirect_url: "",
    meta: this.meta,
    customer: this.customerDetails,
    customizations: this.customizations,
    callback: this.makePaymentCallback,
    onclose: this.closedPaymentModal,
    callbackContext: this,
  };

  constructor(private flutterwaveService: FlutterwaveService) {}
  makePaymentCallback(response: PaymentSuccessResponse): void {
    console.log("Pay", response);
    this.flutterwaveService.closePaymentModal(5);
  }
  closedPaymentModal(): void {
    console.log("payment is closed");
  }
  generateReference(): string {
    let date = new Date();
    return date.getTime().toString();
  }
}

Using Flutterwave directly in your code

Method 1

Using the Flutterwave service.

import { Component } from "@angular/core";
import {
  FlutterwaveService,
  InlinePaymentOptions,
  PaymentSuccessResponse,
} from "flutterwave-angular-v3";

@Component({
  selector: "app-root",
  template: `<button (click)="makePayment()">Pay</button>`,
})
export class AppComponent {
  publicKey = "FLWPUBK_TEST-XXXXXXXXX";

  customerDetails = {
    name: "Demo Customer  Name",
    email: "customer@mail.com",
    phone_number: "08100000000",
  };

  customizations = {
    title: "Customization Title",
    description: "Customization Description",
    logo: "https://flutterwave.com/images/logo-colored.svg",
  };

  meta = { counsumer_id: "7898", consumer_mac: "kjs9s8ss7dd" };

  paymentData: InlinePaymentOptions = {
    public_key: this.publicKey,
    tx_ref: this.generateReference(),
    amount: 10,
    currency: "NGN",
    payment_options: "card,ussd",
    redirect_url: "",
    meta: this.meta,
    customer: this.customerDetails,
    customizations: this.customizations,
    callback: this.makePaymentCallback,
    onclose: this.closedPaymentModal,
    callbackContext: this,
  };
  //Inject the flutterwave service
  constructor(private flutterwaveService: FlutterwaveService) {}
  makePayment() {
    this.flutterwaveService.inlinePay(this.paymentData);
  }
  makePaymentCallback(response: PaymentSuccessResponse): void {
    console.log("Payment callback", response);
  }
  closedPaymentModal(): void {
    console.log("payment is closed");
  }
}

Method 2 (Promise)

Async Payment Response.

import { Component } from "@angular/core";
import { FlutterwaveService, AsyncPaymentOptions } from "flutterwave-angular-v3";

@Component({
  selector: "app-root",
  template: ` <button (click)="payViaPromise()">Pay via Promise</button>`,
})
export class AppComponent {
  publicKey = "FLWPUBK_TEST-XXXXXXXXX";

  customerDetails = {
    name: "Demo Customer  Name",
    email: "customer@mail.com",
    phone_number: "08100000000",
  };

  customizations = {
    title: "Customization Title",
    description: "Customization Description",
    logo: "https://flutterwave.com/images/logo-colored.svg",
  };

  meta = { counsumer_id: "7898", consumer_mac: "kjs9s8ss7dd" };

  paymentData: AsyncPaymentOptions = {
    public_key: this.publicKey,
    tx_ref: this.generateReference(),
    amount: 10,
    currency: "NGN",
    payment_options: "card,ussd",
    meta: this.meta,
    customer: this.customerDetails,
    customizations: this.customizations,
  };

  constructor(private flutterwaveService: FlutterwaveService) {}

  payViaPromise() {
    this.flutterwaveService.asyncInlinePay(this.paymentData).then((response) => {
      console.log("Promise Res", response);
      this.flutterwaveService.closePaymentModal(5);
    });
  }
  generateReference(): string {
    let date = new Date();
    return date.getTime().toString();
  }
}

Recurring Payments

Pass the payment plan ID into your payload to make recurring payments.

import { Component, OnInit } from "@angular/core";
import {
  FlutterwaveService,
  InlinePaymentOptions,
  PaymentSuccessResponse,
} from "flutterwave-angular-v3";
@Component({
  selector: "app-root",
  template: ` <flutterwave-make-payment
    [public_key]="publicKey"
    amount="10"
    currency="NGN"
    payment_options="card"
    payment_plan="6341"
    redirect_url=""
    text="Pay for Payment Plan"
    [customer]="customerDetails"
    [customizations]="customizations"
    [meta]="meta"
    [tx_ref]="generateReference()"
    (callback)="makePaymentCallback($event)"
    (close)="closedPaymentModal()"
  >
  </flutterwave-make-payment>`,
})
export class AppComponent {
  //use your PUBLIC_KEY here
  publicKey = "FLWPUBK_TEST-XXXXX-X";

  customerDetails = {
    name: "Demo Customer  Name",
    email: "customer@mail.com",
    phone_number: "08100000000",
  };

  customizations = {
    title: "Customization Title",
    description: "Customization Description",
    logo: "https://flutterwave.com/images/logo-colored.svg",
  };

  meta = { counsumer_id: "7898", consumer_mac: "kjs9s8ss7dd" };

  constructor(private flutterwaveService: FlutterwaveService) {}

  makePaymentCallback(response: PaymentSuccessResponse): void {
    console.log("Pay", response);
    this.flutterwaveService.closePaymentModal(5);
  }
  closedPaymentModal(): void {
    console.log("payment is closed");
  }
  generateReference(): string {
    let date = new Date();
    return date.getTime().toString();
  }
}

Parameters

Read more about our parameters and how they can be used here.

Methods

Methods provided by FlutterwaveService and descriptions:

Debugging Errors

We understand that you may run into some errors while integrating our library. You can read more about our error messages here.

For authorization and validation error responses, double-check your API keys and request. If you get a server error, kindly engage the team for support.

NB: If you experience compilation errors in your app after importing the Flutterwave module, component or service. Kindly include the following line in tsconfig.app.json under compilerOptions :

paths": { "@angular/*": [ "node_modules/@angular/*" ] }

Then restart server and try again

Support

For additional assistance using this library, please create an issue on the Github repo or contact the developer experience (DX) team via email or on slack.

You can also follow us @FlutterwaveEng and let us know what you think 😊.

Contribution Guidelines

We welcome contributions from the community. Read more about our community contribution guidelines here.

License

By contributing to this library, you agree that your contributions will be licensed under its MIT license.

Copyright (c) Flutterwave Inc.