Skip to content

Commit 2204e9b

Browse files
add new content to developer docs.
1 parent 06d316e commit 2204e9b

1 file changed

Lines changed: 56 additions & 62 deletions

File tree

README.md

Lines changed: 56 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -2,57 +2,58 @@
22
<img title="Flutterwave" height="200" src="https://flutterwave.com/images/logo/full.svg" width="50%"/>
33
</p>
44

5-
# Flutterwave Flutter Standard SDK
5+
# Flutterwave Flutter(Standard) SDK
66

7-
## Table of Contents
8-
9-
- [About](#about)
10-
- [Getting Started](#getting-started)
11-
- [Usage](#usage)
12-
- [Deployment](#deployment)
13-
- [Built Using](#build-tools)
14-
- [References](#references)
15-
- [Support](#support)
7+
The Flutter library helps you create seamless payment experiences in your dart mobile app. By connecting to our modal, you can start collecting payment in no time.
168

17-
<a id="about"></a>
18-
## About
19-
Flutterwave's Flutter SDK is Flutterwave's offical flutter sdk to integrate Flutterwave's [Standard](https://developer.flutterwave.com/docs/flutterwave-standard) payment into your flutter app. It comes with a ready made Drop In UI.
9+
Available features include:
2010

11+
- Collections: Card, Account, Mobile money, Bank Transfers, USSD, Barter.
12+
- Recurring payments: Tokenization and Subscriptions.
13+
- Split payments
2114

15+
## Table of Contents
2216

23-
<a id="getting-started"></a>
24-
25-
## Getting Started
17+
1. [Requirements](#requirements)
18+
2. [Installation](#installation)
19+
3. [Usage](#usage)
20+
4. [Support](#support)
21+
5. [Contribution guidelines](#contribution-guidelines)
22+
6. [License](#license)
2623

27-
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See [deployment](#deployment) for notes on how to deploy the project on a live system.
28-
See [references](#references) for links to dashboard and API documentation.
2924

30-
### Prerequisite
25+
## Requirements
3126

32-
- Ensure you have your test (and live) [API keys](https://developer.flutterwave.com/docs/api-keys).
33-
```
34-
Flutter version >= 1.17.0
35-
Flutterwave version 3 API keys
36-
```
27+
1. Flutterwave for business [API Keys](https://developer.flutterwave.com/docs/integration-guides/authentication)
28+
2. Supported Flutter version >= 1.17.0
3729

38-
### Installing
30+
## Installation
3931

40-
**Step 1.** Add the dependency
32+
1. Add the dependency to your project. In your `pubspec.yaml` file add: `flutterwave_standard: 1.0.2`
33+
2. Run `flutter pub get`
4134

42-
In your `pubspec.yaml` file add:
35+
## Usage
4336

44-
1. `flutterwave_standard: 1.0.2`
45-
2. run `flutter pub get`
37+
### Initializing a Flutterwave instance
4638

47-
<a id="usage"></a>
48-
## Usage
39+
To create an instance, you should call the Flutterwave constructor. This constructor accepts a mandatory instance of the following:
4940

50-
### 1. Create a `Flutterwave` instance
41+
- The calling `Context`
42+
- `publicKey`
43+
- `Customer`
44+
- `amount`
45+
- `currency`
46+
- `email`
47+
- `fullName`
48+
- `txRef`
49+
- `isDebug`
50+
- `paymentOptions`
51+
- `Customization`
5152

52-
Create a `Flutterwave` instance by calling the constructor `Flutterwave` The constructor accepts a mandatory instance of the following:
53-
the calling `Context` , `publicKey`, `Customer`, `amount`, `currency`, `email`, `fullName`, `txRef`, `isDebug`, `paymentOptions`, and `Customization` . It returns an instance of `Flutterwave` which we then call the `async` method `.charge()` on.
53+
It returns an instance of Flutterwave which we then call the async method `.charge()` on.
5454

55-
_handlePaymentInitialization() async {
55+
```dart
56+
_handlePaymentInitialization() async {
5657
final style = FlutterwaveStyle(
5758
appBarText: "My Standard Blue",
5859
buttonColor: Color(0xffd0ebff),
@@ -89,14 +90,14 @@ Create a `Flutterwave` instance by calling the constructor `Flutterwave` The con
8990
customization: Customization(title: "Test Payment"),
9091
isDebug: true);
9192
}
93+
```
9294

9395

94-
### 2. Handle the response
96+
### Handling the response
9597

96-
Calling the `.charge()` method returns a `Future`
97-
of `ChargeResponse` which we await for the actual response as seen above.
98+
Calling the `.charge()` method returns a Future of `ChargeResponse` which we await for the actual response as seen above.
9899

99-
```
100+
```dart
100101
final ChargeResponse response = await flutterwave.charge();
101102
if (response != null) {
102103
print(response.toJson());
@@ -110,37 +111,30 @@ Create a `Flutterwave` instance by calling the constructor `Flutterwave` The con
110111
}
111112
```
112113

114+
#### Note:
115+
1. `ChargeResponse` can be null if a user cancels the transaction by pressing back.
116+
2. You need to confirm the transaction is succesful. Ensure that the txRef, amount, and status are correct and successful. Be sure to [verify the transaction details](https://developer.flutterwave.com/docs/verifications/transaction) before providing value.
117+
118+
# Support
119+
120+
For additional assistance using this library, contact the developer experience (DX) team via [email](mailto:developers@flutterwavego.com) or on [slack](https://bit.ly/34Vkzcg).
121+
122+
You can also follow us [@FlutterwaveEng](https://twitter.com/FlutterwaveEng) and let us know what you think 😊.
113123

124+
# Contribution guidelines
114125

115-
#### Please note that:
116-
- `ChargeResponse` can be null, depending on if the user cancels
117-
the transaction by pressing back.
118-
- You need to check the status of the transaction from the instance of `ChargeResponse` returned from calling `.charge()`, the `status`, `success` and `txRef` are successful and correct before providing value to the customer
126+
Read more about our community contribution guidelines [here](/CONTRIBUTING).
119127

120-
> **PLEASE NOTE**
128+
# License
121129

122-
> We advise you to do a further verification of transaction's details on your server to be sure everything checks out before providing service.
123-
<a id="deployment"></a>
124-
## Deployment
130+
By contributing to the {{language}} library, you agree that your contributions will be licensed under its [MIT license](/LICENSE).
125131

126-
- Switch to Live Mode on the Dashboard settings page
127-
- Use the Live Public API key from the API tab, see [here](https://developer.flutterwave.com/docs/api-keys) for more details.
132+
Copyright (c) Flutterwave Inc.
128133

129-
<a id="build-tools"></a>
130-
## Built Using
134+
135+
# Built Using
131136
- [flutter](https://flutter.dev/)
132137
- [http](https://pub.dev/packages/http)
133138
- [flutter_inappwebview](https://pub.dev/packages/flutter_inappwebview)
134139
- [fluttertoast](https://pub.dev/packages/fluttertoast)
135140

136-
<a id="references"></a>
137-
## Flutterwave API References
138-
139-
- [Flutterwave API Doc](https://developer.flutterwave.com/docs)
140-
- [Flutterwave Inline Payment Doc](https://developer.flutterwave.com/docs/flutterwave-inline)
141-
- [Flutterwave Dashboard](https://dashboard.flutterwave.com/login)
142-
143-
<a id="support"></a>
144-
## Support
145-
* Have issues integrating? Reach out via [our Developer forum](https://developer.flutterwave.com/discuss) for support
146-

0 commit comments

Comments
 (0)