Qosic Dart
A Very Good Project created by Very Good CLI.
About
❓
This package is a simple way to handle Qosic's USSD payment. It allows you to integrate mobile money payment into your Dart and Flutter app.
Installation
💻
Add qosic_dart to your pubspec.yaml:
dependencies:
qosic_dart:
Install it:
dart pub get qosic_dart
Usage
🔨
Make a payment
A simple example of how to compute a USSD payment with QOSIC
final qosic = QosicDart(
moovKey: 'XXXXXXXXXx',
mtnKey: 'XXXXXXXXXX',
username: 'XXXXXXXXXX',
password: 'XXXXXXXXX',
);
final transactionRef = await qosic.pay(
network: QosicNetwork.mtn,
phoneNumber: 'XXXXXXXX', /// precedeed by the country code. ex: 229XXXXXXXX
amount: '1',
);
Timer.periodic(
const Duration(
seconds: 10, /// feel free to give your own second to wait
/// but I will advice you between 7 and 10 secs
),
(timer) async {
final status = await qosic.getPaymentStatus(
transactionReference: transactionRef!,
network: QosicNetwork.mtn,
country: QosicCountry.benin,
);
if (status == QosicStatus.successfull || status == QosicStatus.failed) {
timer.cancel();
if (status == QosicStatus.successfull) {
log("Success for payment");
} else {
log("Payment failed");
}
}
},
);
Continuous Integration
🤖
Qosic Dart comes with a built-in GitHub Actions workflow powered by Very Good Workflows but you can also add your preferred CI/CD solution.
Out of the box, on each pull request and push, the CI formats, lints, and tests the code. This ensures the code remains consistent and behaves correctly as you add functionality or make changes. The project uses Very Good Analysis for a strict set of analysis options used by our team. Code coverage is enforced using the Very Good Workflows.
Running Tests
🧪
To run all unit tests:
dart pub global activate coverage 1.2.0
dart test --coverage=coverage
dart pub global run coverage:format_coverage --lcov --in=coverage --out=coverage/lcov.info
To view the generated coverage report you can use lcov.
# Generate Coverage Report
genhtml coverage/lcov.info -o coverage/
# Open Coverage Report
open coverage/index.html
6 Nov 10, 2022
659 Dec 25, 2022
1 Jun 19, 2022
4 Sep 20, 2022
2 Feb 4, 2022
3 May 26, 2022
185 Dec 13, 2022
9 Dec 6, 2022
30 Nov 10, 2022
311 Jan 2, 2023